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PREFACE 



This manual provides information for system planners and support personnel involved in the planning and configuration of 
an OS/16MT2 System. 

Chapter 2 of this manual describes how to choose the configuration options in order to tailor an OS/16-MT2 system to a 
specific environment. It assumes tliat the reader is familiar with the concepts discussed in Chapter 1 of the OS/16-MT2 
Programmer's Reference Mamial. 

Chapter 3 discusses the packaging of the components of OS/16-MT2 and its related utilities. 

Chapter 4 discusses the process of System Generation (SYSGEN). 

Chapter 5 discusses the compatibility of OS/ 16 MT2 with other INTBRDATA operating systems. 

Chapter 6 discusses the use of OS/1 6 MT2 on a processor with greater than 64KB and gives examples. 

This manual furnishes a glossary of terms. These terms, used throughout OS/ 16 MT2 documentation, should be understood 
by the reader. 
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CHAPTER 1 
INTRODUCTION 



SYSTEM DESCRIPTION 

This manual provides ttie information necessary to plan and configure an OS/16 MT2 System. Because of its content, this 
manual is necessary reading for the system planners and support personnel involved in generating an OS/16 MT2 System. 

The OS/ 16 MT2 System is a modular, general purpose, real-time operating system. The system may be configured to 
support a varied number of hardware and application environments, from a large system to a single user, batch oriented, 
program development system. The capability for tailoring an OS/ 16 MT2 system to the desired environment ensures that 
the available resources (i.e., memory, peripherals, and time) are used in the most efficient manner while still providing the 
desired functions. 

DOCUMENTATION OVERVIEW 

The documentation for OS/16-MT2 and its related utihties is contained in the OS/ 16- MT2 Documentation Package (Refer 
to Chapter 3). 

The recommended reading order of the information contained in the documentation package is as follows: 

1. Overview of OS/16-MT2 - OS/16-MT2 Programmer's Reference Manual, Publication Number 29-429 
(Chapter 1). 

2. System Planning Considerations OS/16-MT2 Svstem Planning and Configuration Guide, Publication 
Number 29-43 1 (Chapter 2). 

3. System Packaging and Components - OS/16-MT2 System Planning and Configuration Guide, Publication 
Number 29-431 (Chapter 3). 

4. System Generation ~ OSI16-MT2 System Planning and Configuration Guide, Publication Number 
29-431 (Chapter 4). 

5. Operator Commands — 0S/16-MT2 Operator's Reference Manual, Publication Number 29-430 
(Chapters 2 and 3). 

6. Programming Under OS/16 - OS/16-MT2 Programmer's Reference Manual, Publication Number 29-429 
(Chapters 2, 3, 4, and 5). 

7. Establishing Tasks and System Console Operation - OS/16-MT2 Operator's Reference Manual, 
Publication Number 29-430 (Chapters 5, 6, 7, 8, and 9). 
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CHAPTER 2 
SYSTEM PLANNING 



INTRODUCTION 

OS/ 16 MT2 offers many optional features and support for a wide range of devices. For a system to be efficient and of 
reasonable size, it must be tailored to the specific hardware configuration and the needs of the user. The first step in the 
System Generation (SYSGEN) is to plan the system and define the system parameters for input to the OS/ 16 MT2 
Configuration Utility Program (CUP/ 16). This chapter discusses various aspects of the system that should be considered. 
The remaining steps in the SYSGEN procedure, as illustrated in Figure 2-1 , are discussed in Chapter 4 of this manual. 



SYSTEM 
PARAMETERS 



CUP/16 
OUTPUT 




08/16 MT2 

LOAD 

MODULE 



OS/16MT2 

SOURCE 

MODULES 



OS/16 MT2 
DRIVER LIBRARY 
OBJECT MODULES 



TET/16 0R 

OS/16 LIBRARY 

LOADER 



Figure 2-1. OS/16-MT2 SYSGEN Procedure 



29431 ROl 6/76 



2-1 



SYSTEM OVERLAYS AND FUNCTION DELETION 

The two SYSGEN considerations which have thie greatest effect on system size and performance are the deletion of 
unneeded functions and the use of system overlays. 

Function Deletion 

The DELETE configuration statement allows the system planner to reduce the memory requirements of the system by 
eliminating unneeded functions. The description of the DELETE command in Chapter 4 discusses the functions available 
for deletion, and the amount of memory saved for each. Most of the functions are self explanatory. Some implications of 
function deletion are : 

These functions include : 

Image loader 
Object code loader 

- Task overlay loader 
Intertask communication 

- Display features 

- Examine and modify memory 
System logging 

- Bulkstorage positioning commands 

For a small dedicated application system, as described later in this chapter, the following can be deleted: 

- Command Processor module with all related functions 

- File Manager module 

- Power fail recovery 

Software support for multiply /divide instructions 

It is recommended that all unnecessary functions be deleted. For example, the code which initializes the system also may 
be chosen for deletion. If this option is selected, system initialization code is overlaid following initialization. The system 
cannot be restarted but must be reloaded. This option is recommended for any production environment system. 

In addition to the functions deleted by the DELETE command, the following support is eliminated from the configured 
system unless specifically requested by the appropriate SYSGEN command (see Chapter 4): 

- Command Substitution System support 

- Clock support 

- Journal support 
- Safety checks 

Floating point 

- Roll support 

- Index File support 

- Halt I/O support 

Some functions are automatically deleted if they are seen to be redundant. For example: 

1. If the image loader is deleted, the task overlay loader is deleted. 

2. If no disc device is specified, disc management support is deleted. 

3. On a background-only system, the TASK command is deleted. The current Task Id is always .BG . 

4. On a background-only non-disc system, the SET PARTITION command is deleted. All available 
memory is in the background partition and no dynamic system space is required. 
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System Overlays 

OS/16-MT2 provides the capability for maintaining the routines necessary for the support of certain functions on a Disc 
File, bringing them into memory only when necessary. The use of such system overlays provides significant savings in 
memory . 

System overlays may be requested for a Disc based system only. There are four categories of system overlays: 



1 . Command Processor - 

2. SVC 7 

3. SVC 5 and SVC 6 

4. SVC 2 



All operator commands are overlaid 

File manager functions are overlaid 

Intertask communication and fetch overlay functions are overlaid 

SVC 2 utility functions are overlaid 



Selecting the option to overlay the Command Processor saves the most storage of any overlay option and is recommended 
for any disc system. Command Processor overlays require one to three Disc accesses for each operator command entered. 
Command Processor overlays are required if any other overlays are chosen. If Command Processor overlays are selected, 
the deletion of commands will not reduce the system size further and is therefore not recommended. 

Overlaying the file manager can also save significant amounts of memory without affecting system throughput signifi- 
cantly. Common SVC 7 operations such as ALLOCATE, ASSIGN and CLOSE require an extra Disc access, but since these 
operations are performed infrequently, the extra time is negligible. This is especially true compared to the probable 
number of Disc accesses the program may have. SVC 7 overlays are also recommended for any Disc system. 

SVC 6 overlays can directly affect task response time. The time in which a task can start or cancel another increases from 
about 500 microseconds to tens of milliseconds, depending upon Disc access time. On the other hand, the SVC 6 load 
function is not greatly affected since a load operation requires Disc or other I/O anyway. In any case, the user must judge 
from the desired system response and memory requirements whether or not SVC 6 functions should be overlaid. Unless 
memory savings are critical and intertask control response time is not critical, it is recommended that the SVC 6 not be 
overlaid. 

SVC 2 overlays can also cause a noticeable decrease in system response. Many operator commands use SVC 2 functions and 
each use adds one Disc access. User programs that use SVC 2 functions, especially in program loops, are affected. Agam, 
the user must examine the particular system requirements in deciding upon SVC 2 overlays. 



The amount of overhead time added by using SVC 2, 6, and 7 overlays also depends upon two other factors: 

Average Disc Access If the Disc containing the system overlay file is also heavily accessed by user tasks, the average 

access time is increased. 



If the SVC 2, 6 or 7 operation requested is the same as the last one requested, no Disc Access is 
required. 



Repeat Operation 

The approximate amount of memory saved by selecting each overlay category is contained in Table 2-1 . 



TABLE 2-L MEMORY SAVINGS FOR SYSTEM OVERLAYS 



SELECTED OVERLAY 


MEMORY SAVINGS 
(DECIMAL) 


Command Processor 
SVC 7 
SVC 6 
SVC 2 


11000 bytes 
4000 bytes 
1000 bytes 
1000 bytes 
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SCHEDULING 

Tasks are scheduled on a priority basis. There are 255 possible levels. A number of tasks can be assigned to the same 
priority. Within one priority level, scheduling is based on partition number; a lower partition is considered higher priority. 

As an option, round-robin scheduling can be specified; the order of scheduling for tasks within one priority level is rotated 
each time one of them relinquishes control of the system. Each time the priority of a task is changed in an OS/16-MT2 
environment, all the tasks in the system are reordered by priority. 

Round-robin scheduling adds a slight overhead everytime the OS responds to any interrupt. In a system with a high rate of 
I/O interrupt or clock support, this overhead may be excessive since every interrupt, including the clock, causes a 
reordering of tasks on the priority level of the active task. In systems intended for running multiple users of BASIC or 
similar terminal oriented programs, round-robin scheduling is necessary to prevent one task from locking out other, equal 
priority, users of the same program. 

CLOCK SUPPORT 

By specifying the resolution of the Precision Interval Clock (PIC), using the INTERVAL configuration statement, the user 
specifies the interval between successive interrupts from the clock. The interval selected must be no higher than the 
smallest resolution needed by any task which may execute on the target system. This number should be as large as possible 
for systems with round-robin scheduling, as the clock interrupt causes a priority reordering at the interval specified. Note 
that the PIC is only running if there is a task in time wait (SVC 2,23). A system with no PIC support does not support time 
wait (SVC 2,23). 

COMMAND SUBSTITUTION SYSTEM (CSS) 

CSS support is not part of the basic system, and if required, must be requested by the CSS SYSGEN statement which also 
defines the maximum depth for nested calls. 

The logic to handle CSS increases the size of a non-overiayed system by approximately 2KB, but has no effect on the size 
of an overiayed system. There is in addition one command input buffer per CSS level. The length of each buffer is by 
default 64 bytes, but can be adjusted by the CMDLEN statement witliin the range 32 to 124 bytes. A large buffer size may 
be desirable for CSS because: 

commands can be input from any ASCII file or device and are not limited by the maximum line length of 
the system console device. 

- Parameter substitution can cause command lines as input to be expanded. 

In considering final system size, it is recommended that both the buffer length and the number of levels be kept to a 
minimum depending on the application. A buffer length of 80 bytes with support for 2 to 4 levels of CSS should be 
adequate for most users. The OS/ 16 MT2 High Level Operator Command Package requires 2 levels of CSS. 

HARDWARE RELATED PLANNING 

The overall size of a system depends partly on the type of processor and its peripherals. For example, a system built for a 
basic 7/16 will be neariy X'300' larger than an identical system for a model 70, because of the requirement for software 
emulation of List and Multiply /Divide instructions on processors with no hardware support. Support for the peripherals 
configured in a system involves: 

one driver for each type of device. 

one Device Control Block (DCB) for each device. 

For users who have a number of disc-based 1 6-bit hardware systems of differing configuration, it is recommended that a 
system be generated for each rather than a single system which would run on any of the hardware configurations. A 
number of software systems can be built onto one disc pack. Each is built onto a standard contiguous disc file and is 
identified by a unique three-character file extension. The same disc pack can be used on any of the systems by simply 
boot-loading the appropriate software system. 



24 29431 ROl 6/76 



SYSTEM MODULE DELETION 

OS/ 16 MT2 comprises four main modules: 

— Executive 

— Driver Library 
- File Manager 

— Command Processor 

A minimum system is configured through the deletion of two of the main modules of the OS, the Command Processor and 
the File Manager, and the trimming down of the third, the Executive. Deleting the Command Processor module has the 
greatest impact on the system. It greatly reduces the system size, enabling the system to run on a 16-bit processor with less 
than 16KB memory. It also affects system operation. Since it deletes the operator interface, the entire system including the 
tasks must be planned before the system is generated. The operator cannot dynamically change the system once it is 
running. 

The most basic system, designed to operate in a minimum of 8KB memory offers: 

— Automatic interrupt handling 

— Device independent I/O through standard supervisor services (SVC 1) 

— No requirement (and no support) for an interactive console device 

— Support for single task or multi-tasking with scheduling on a priority basis 

— Optional recovery from power failure 

Essential functions normally performed by the Command Processor in preparing and starting a task are achieved through 
commands to the Configuration Utility Program (CUP/16). Since there is no resident loader in the system, tasks are built in 
with the main OS modules at system generation. When the system is loaded, all tasks that were preset Ready will be 
scheduled for execution. 

The Executive-only system supports application programs which have been prepared and tested under OS/16 MT2 on a 
Model 7/16 or equivalent with a minimum of 32KB memory. It offers no support for the standard utilities supplied with 
the OS/ 16 MT2 package, and cannot be used for program development or system generation since it has no operator 
interface. 

As a SYSGEN option, intertask communication facilities may be included in this minimum system. This makes the system 
more flexible, not only allowing tasks to be aware of each other, but also allowing them to be dynamically loaded into 
partitions at run-time. Clock support (line frequency and precision interval) is optional, as in the full system. Recovery 
from power failure is also optional. This system supports I/O on discs and other standard devices but offers no file 
management. As a SYSGEN option, the File Manager can be included with the Executive. 

The following sections in this chapter discuss the minimum system in more detail, giving information on programming for, 
building and controlling systems with no Command Processor. 

Deleting the Command Processor 

Deleting the Command Processor deletes the following features: 

— operator command input and processing 

— the system console driver 

— the resident loaders 

— CSS support 

— Roll support 

With no operator interface through a system console device, at least one task must be built in with the system in a Ready 
state (see TASK statement) so that it begins executing as soon as the system is loaded. If the system supports SVC 6 and 7, 
one control task can load and start other tasks, which can make their own LU assignments. Other areas of the system may 
be overlayed (SVCs 2, 6, 7) even though the command processor is deleted. With no system console device and if SVC 2 is 
not deleted, the SVC 2 function 'log message' is treated as legal but causes no action to be taken. The log message request 
is ignored. The SVC 2 function 'pause' will cause the task to be put in a permanent paused state. 

The Command Processor module contains the Command Processor plus the system initialization code. Even if the 
Command Processor is deleted, the Command Processor module must be included when the system is built. 
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Deleting the File Manager 

If the Command Processor is deleted, the File Manager, complete with all SVC 7 functions, can be deleted. With no SVC 7 
support, all devices must be pre-assigned at system generation. On the standard system, this request will be ignored since 
SVC 7 is required by the Command Processor itself. 

Deleting Parts of the Executive 

As on the standard system, the following can be deleted: 

1 . The image loader (one of the SVC 6 functions) 

2. The task overlay loader (SVC 5) 

3. All intertask communication functions, including the image loader and the overlay loader (all SVC 5 
and 6 functions) 

4. Power fail recovery 

In addition the 'end of task' logic (SVC 3) which closes or checkpoints the task's logical units is automatically deleted if 
there is no File Manager (SVC 7). 

If the Command Processor is deleted, SVC 2 functions can also be deleted. On the standard system, a request to delete 
SVC 2 is ignored because SVC 2 is required by the Command Processor itself. On a system with no Command Processor 
but with Qock support, a request to delete SVC 2 deletes all but the clock-related functions, SVC 2 codes 8, 9 and 23. On 
a system with no Command Processor and no Clock support, all SVC 2 functions are deleted. 

Deleting Multiply /Divide Software Support 

By default, any system without hardware multiply/divide (M/D), being defined by the CUP statement 'PROC 2', is 
generated with M/D software traps. M/D instructions are used by the system itself; by the Command Processor and the disc 
driver. In the minimum Executive-only system, M/D support is only required if the user's tasks execute multiply and/or 
divide instructions. 

Any user who does not require M/D support can request that it be deleted. The software traps are deleted on a system 
which 

has no hardware M/D, 
- has no Command Processor, and 
has no disc support. 

On any other system, this request has no effect. 

Other Sysgen Options 

There is no support for the memory protect controller. Two additional CUP statements, described in the following section, 
enable tasks and LU assignments to be defined. 

Tlie following configuration options are still valid on the Executive-only system: 

Clock support 

- Floating point support 
Round-robin scheduling 

- Safety checks 

- Foreground partitions 
Definition of type of processor 

- Logical Units/Devices 

The Setting of Partitions, Tasks and LU Assignments 

This section refers specifically to systems with no Command Processor. There is no way to adjust partitions and load the 
first task once the system is loaded. Object code tasks are hnked into the operating system at system generation, and are 
loaded in a preset 'Ready' or 'Dormant' state along with the system itself. 

Tasks must be coded complete with: 

1 . A UDL area - size depends on floating point support. 

2. Main code. 

3. Get storage or work space area. 
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The size of the task as coded determines the size of its partition. A task can be one object code program or a number 
linked together. ENTRY symbols must not be duplicated with the OS or any other tasks in the system. See Appendix 7 for 
a list of OS ENTRY symbols. A task should not be coded with a transfer address on the END statement. The starting 
location is defined through a CUP statement. Tasks which have a transfer address declared in the source code may be 
linked in only if the last (highest addressed) task declares a transfer address of X'60'. Otherwise control will be passed 
directly to a task instead of system initiaUzation when the system is loaded. Common blocks and re-entrant libraries are 
supported; a library or common block is linked in as a task and preset 'Dormant' so that it is never executed as a task in its 
own right. 

To be able to set up various system tables, information has to be passed through CUP/16. The syntax of the TASK 
statement is 

R 



TASK tn,TASKID,XFER,ip,mp, 



or 
D 



[,opt [ ,opt j . .. j 



where: tn = the task number in decimal. refers to the lowest task in memory, 1 to the next task, etc. in address 
order, 
tn must be less than or equal to the value of FOREGRND. 

TASKID = 1 to 6 character ENTRY symbol at start of task's UDL 

XFER = 1 to 6 character ENTRY symbol at task's starting location 

ip = initial task priority 

mp = maximum task priority 

R 

or = Ready or Dormant 

D 

opt = option given by one of the following mnemonics: 

ET Executive task 

FL Single Precision Floating Point 

DFL Double Precision Floating Point 

RES Resident 

COMP Uses old SVC parameter blocks; make compatible 

By default a task is considered as: 

User task 

No floating point 

Non-resident 

Not roUable 

Having OS/ 16 MT2 SVC parameter blocks 

Arithmetic Fault Continue 

This statement must be entered for every task built into the system. 

On a system with file management, the dynamic system space area must be defined to allow for the setting up of File 
Control Blocks (FCBs). The start of the area is defined by ENTRY symbol 

.SYS 

This must be declared by the user at the end of the last (highest addressed) task to be loaded. If assembled as an individual 
'dummy' task, it can be linked in last on any system generation. On a system with no file management, the start of the 
system space is set to the top of memory, and the symbol .SYS has no special meaning. It is recommended that this 
dummy task be given a transfer address of X'60'. 

Example of CAL Source Code for task .SYS 

.SYS PROG DUMMY TASK .SYS 

ENTRY .SYS 

.SYS END X'60' START AT SYS INIT 

LU assignments for devices and bare discs can be preset for each task/partition through the following CUP statement: 
ASSIGN tn,lu,dn,dcod 

where: tn = the task number in decimal. refers to the lowest task in memory, 1 to the next task, etc. in address 
order, 
tn must be less than or equal to the value of FOREGRND. 

lu = logical unit number 

dn = device mnemonic 
dcod = device code 
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Note that there is no support for file assignment. 

In declaring its UDL, the task must set up the system pointers which are normally set up by the system when a task is 
loaded. The first four halfword items in the UDL are: 

1 . CTOP Highest halfword of user's memory 

2. CBOT Bottom of common area 

3. UTOP First halfword following user program 

4. UBOT Partition start address 

CTOP, CBOT, and UBOT are not required by the system itself, but must be declared as address constants of appropriately 
placed symbols within the program if they are to be accessed by the task during execution, through an SVC 2 'fetch 
pointer' call. UTOP must be declared as an address constant of a symbol placed at the end of the program code if the task 
issues an SVC 2 'Get Storage' call. 



Example: 





ENTRY PARTN,START 




PARTN 


DC CTOP 


CTOP 




DC CTOP 


CBOT=CTOP 




DC UTOP 


UTOP 




DC PARTN 


UBOT 




DS 28 


REST OF UDL 


START 


EQU * 
(Executable Code ) 
(Program Data Area ) 


PROGRAM START 


UTOP 


EQU * 






DS 254 


GET STORAGE AREA 


CTOP 


DS 2 






END 


END OF PARTN 



Building The System 

The Library Loader is used to build an absolute object code load module which is loaded by the Relocating Loader. For a 
system with disc support, TET/16 can be used to build an image load module onto a disc. 

Tasks are linked in with the main OS modules as follows: 



Executive 

Drivers 

Optional File Manager 

Command Processor 

TaskO 

Taskl 



(must be first) 

(holds system initialization— must be last) 



Task n 
-SYS 

Tasks must be linked in order, according to the task numbers specified in the TASK and ASSIGN CUP statements. 

When using the Library Loader, the command 

TOP xxxx where xxxx = top of available memory 

should be used to ensure that the resultant load module will fit in the memory available. The Relocating Loader occupies 
X'400' bytes at the top of memory while loading the system, so 

xxxx = top of physical memory — X'400'. 

The top X'400' bytes form part of the dynamic system space area on systems with file management, and are accessible as 
general workspace for the highest task on systems without. 
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Systems with Full Intertask Communication Support 

A system configured witli full intertask communication support (SVC 6 and SVC 5) gives each task the ability to load, 
start and communicate with any other task. Tasks to be loaded in this way are first estabhshed by TET/16 into image load 
modules. Unlike tasks which are linked in with the Library Loader, these may reference common blocks, call overlay ed 
subroutines, and make use of all the features offered through TET/16. At least one executable task must be built in with 
the system, plus one dummy task for each additional partition to be set up. A dummy task need only define storage (a 
CAL 'DS' instruction) with an ENTRY symbol at the beginning to denote the partition start. A TASK' statement is 
required for each, as for any other task. The single ENTRY symbol doubles as start of partition and starting location, and 
the task is declared Dormant. 

Once the system has been built, the Library Loader or TET/16 system map gives the partition addresses for the actual tasks 
to be established. By consulting the system and task maps, the user can verify that the established tasks fit within the 
preset partitions. 

Note that if no task is overlayed, the overlay loader (SVC 5) can be deleted independently of SVC 6. Also, the SVC 6 
image loader can be deleted independent of the other intertask communication SVC 6 functions. On a system with no 
program development or CSS support, the concept of 'background' has no meaning. All partitions are allowed to execute 
SVC 6 instructions. 

Systems with Full File Management Support 

With SVC 7 and one or more disc devices configured in a system, a task has full file management support. During system 
initialization, an attempt is made to mark online every direct access device configured in the system. Those with hardware 
write-protect are marked on with software protect; the others without protect. The type of protection cannot be changed 
once the system is running. 

Since there is no MARK OFF command, tasks should where possible close or checkpoint all disc files when not in use. 
After the system is taken down, the packs must be Disc Integrity Checked under a full OS/ 16 before the small system is 
restarted. Disc packs which are not Disc Integrity Checked will be marked on with protect the next time the small system 
is restarted. Note that on a system with no Command Processor, disc packs cannot be exchanged while the system is 
running. 

Systems with Timer Management Support 

A system configured with CLOCK support has the timer management SVC 2s. The clock is started during system 
initialization. A buffer in low memory is reserved for the time and date, initially declared as all-zero. Users with a display 
panel can set the time and date in the buffer and restart the system at X'60'. Detailed instructions are given in Appendix 2. 

Not all systems require that an accurate time be set. A 'milliseconds from now' interval wait is independent of time of day. 
The 'fetch time' SVC service gives a base for 'time of day' interval wait if only relative times are important. 

All tasks which are preset Ready will be scheduled for execution once the system is loaded. If it is important that a task 
does not proceed beyond a certain point in its execution until an accurate time has been set, it should be coded to 
repeatedly check the data until a non-zero (non- ASCII-zero) value is found, and then to proceed as normal. 

Note that there is no way to preset the time and date on a processor with no display panel. 

Trap Handling 

All systems support TSW swap (SVC 9) for enabling and handling task traps. 

Power Fall Recovery and Error Recovery 

All tasks should handle their own recovery from power failure. Any task without the power fail trap enabled is put into a 
permanent paused state. On systems with no console panel, the user can delete all system support for power fail recovery. 
This is not recommended for any other system. On any unrecoverable error, the system goes into a permanent wait state. A 
crash code is displayed on processors with a console panel if safety checks are SYSGENed into the system. 
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Support for BASIC Level 11 

On a system dedicated to BASIC Level II, a Command Processor is not required. The features that should be considered for 
inclusion are : 



General supervisor services (SVC 2) 
File management (SVC 7) 
System overlays (SVC 2 and 7) 
Round-robin scheduling 
Line frequency clock support 
Floating point support 
Contiguous and indexed files 
Partitions 

Number of logical units 
Devices supported 



Required 

Required 

Recommended 

Required for multi-users 

Required for multi-users 

Either single precision or double precision is required 

Recommended for direct access devices 

One for single user, 

n + 1 for n users 

10 LUs required 

Recommend minimum of interactive terminal device and disc. 



To support one terminal, the BASIC Level II interpreter is built in with the OS modules as the only task in the system. It is 
preset Ready so that the terminal becomes active as soon as the system is loaded. The terminal remains active until BASIC 
is terminated by the user (QUIT). 

The interpreter is provided as a single program unit in object code format. The task to run on this system is composed of 
three program units, two of which must be prepared by the user before the system is built. The three units are: 

1. UDL area plus control code to assign LU to the terminal device and branch directly to the 
interpreter. 

2. The interpreter. 

3. The memory available to the user. 



Example of UDL and control code program unit: 



UDL 



PROG 



DEDICATED BASIC SYSTEM ~ UDL AND CONTROL CODE 



UDL 



ENTRY 

EXTRN 

DC 

DS 

DC 

DC 

DS 



UDL,START 

BASIC,UTOP,CTOP 

CTOP 

2 

UTOP 

UDL 

124 



CTOP 
CBOT 
UTOP 
UBOT 
REST OF UDL 



START 



ASSIGNO 



EQU 
SVC 
B 

DC 
DC 
DC 
DC 
DC 
DC 
DC 
END 



7, ASSIGNO 
BASIC 

X'4080' 

X'OOOO' 

X'OOOO' 

X'OOOO' 

C'CRT" 

C 

0,0 



START OF CONTROL CODE 
ASSIGN LU TO TERMINAL 
BRANCH TO INTERPRETER 

ASSIGN FOR READ/WRITE 

LUO 

STATUS 

READ/WRITE KEYS 

DEVICE MNEMONIC FOR TERMINAL 

CLEAR FILENAME AND EXTENSION 

SIZE 
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Example of memory declaration: 



MEMORY 


PROG 

ENTRY 


MEMOP 
UTOP, ( 


UTOP 


EQU 
DS 


* 
X'3FFE' 


CTOP 


EQU 
DS 


* 

2 


.SYS 


EQU 
END 


« 
X'60' 



MEMORY AVAILABLE TO USER 



These two program units are assembled by CAL or CAL/16. 

Configuration statements are prepared for input to CUP/ 16. Examples of statements describing the task and the terminal 
device are: 



TASK 
DEVICE 



0, UDL, START, 128,- 128, R, DEL 
34, 10, CRT: 



For a full description of all CUP/ 16 statements, see Chapter 4. 

The three main modules of the operating system, Executive, File Manager and Command Processor, are assembled with the 
CUP/ 16 output. 

The system is built either by TET/16 onto a disc file or by the Library Loader onto magnetic tape or cassette. Since a disc 
device is recommended, the following example shows the building of the system with TET/16. 



Example of commands to TET/16: 



ESTAB 


OS 


Establish OS 


IN 


EXECBAS.OBJ 


Include Exec 


ED 


DLIB16.0BJ 


Edit Drivers 


IN 


FMGRBAS.OBJ 


Include File Manager 


IN 


CMDPBAS.OBJ 


Include Command Processor 


IN 


UDL.OBJ 


Include first program unit 


IN 


BASIC.OBJ 


Include second (interpreter) 


IN 


MEMORY.OBJ 


Include third 


BU 


OS, OS16BAS.001 


Build OS 


MAP 


PR: 


Print maps 


AMAP 


PR: 




END 




Terminate 



The system can now be bootloaded into memory. 

To support more than one terminal, the BASIC interpreter is built into the system as a sharable library segment. It is set 
'Dormant' so that it is never executed as a task in its own right. For each terminal, one control task is required. This task 
contains the following: 



1. UDL area plus control code to assign LU to the terminal device and branch directly to the 
interpreter. 

2. The memory available to the user. 
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Example of control task: 



TERMl 


PROG 


CONTROL T. 




ENTRY 


UDLl, STAR 




EXTRN 


BASIC 


UDLl 


DC 


CTOPl 




DS 


2 




DC 


UTOPl 




DC 


UDLl 


4= 


DS 


124 


START 1 


EQU 


* 




SVC 


7, ASSIGNOl 


if; 


B 


BASIC 


ASSIGNOl 


DC 


X'4080' 




DC 


X'OOOO" 




DC 


X'OOOO' 




DC 


X'OOOO' 




DC 


C'CRTl' 




DC 


C 


:{< 


DC 


0,0 


UTOPl 


EQU 


* 




DS 


X'lFFE' 


CTOPl 


EQU 


* 




DS 


2 




END 





CTOP 
CBOT 
UTOP 
UBOT 
REST OF UDL 



A dummy task declaring the start of the dynamic system space area must be loaded above all other tasks: 



SYS 


PROG 




ENTRY 


.SYS 


EQU 




END 



SYSTEM SPACE 
.SYS 

* 

X'60' 



Example CUP/ 16 statements describing the tasks and terminal devices (for two users): 



TASK 0, BASIC, BASIC, 128, 128, D 

TASK 1, UDLl, STARTl, 128, 128, R,DFL 

TASK 2, UDL2, START2, 128, 128, R, DFL 

DEVICE 34, 10, CRTl: 

DEVICE 34, 12, CRT2: 



Example of TET/ 1 6 commands to build system: 



ESTAB 


OS 


IN 


EXECBAS.OBJ 


ED 


DLIB16.0BJ 


IN 


FMGRBAS.OBJ 


IN 


CMDPBAS.OBJ 


IN 


BASIC.OBJ 


IN 


CONTROLl.OBJ 


IN 


C0NTR0L2.0BJ 


IN 


SYS.OBJ 


BU 


OS, OS16BAS2.002 


MAP 


PR: 


AMAP 


PR: 


END 





The system can now be bootloaded into memory. 
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Support for FORTRAN programs 

FORTRAN programs which do not reference common blocks and are not overlayed can be built into a system with no 
Command Processor. Each task must be built up from one or more individual programs, with a 'UDL' area inserted at the 
beginning and a "Get Storage' area at the end: 

Example of UDL program unit in CAL: 





ENTRY 


UDLO, STARTO 






EXTRN 


CTOPO, UTOPO 




UDLO 


DC 


CTOPO 


CTOP 




DC 


CTOPO 


CBOT 




DC 


UTOPO 


UTOP 




DC 


UDLO 


UBOT 




DS 


60 


REST OF UDL 


STARTO 


EQU 
END 


* 


START 


Example 


of Get Storage program 


unit in CAL: 






ENTRY 


CTOPO, UTOPO 




UTOPO 


EQU 


* 


GET STORAGI 




DS 


X'2FE' 




CTOPO 


DS 


2 






END 




END OF TASK 



On system with SVC 7, to assign logical units before entering the FORTRAN program, code must be inserted at the end of 
the UDL program unit, following the start ENTRY symbol. 



Example: 



STARTO 


EQU 


* 




SVC 


7, ASSIGNS 




B 


GO 


♦ 






ASSIGNS 


DC 


X'408O' 




DC 


X'OOOS' 




DC 


X'OOOO' 




DC 


X'OOOO" 




DC 


C'TTY' 




DC 


C 


* 


DC 


0,0 


GO 


EQU 
END 


* 



assign LU 5 to teletype 



assign for read/write 

Logical Unit S 

Status 

read/write keys 

device mnemonic for teletype 

clear filename and extension (12 space characters) 

Size 

branch to program 



The 



CAL-coded program units are assembled using CAL/16. Example of CAL/16 run, giving operator command: 



LD 


CAL 16 


AS 


1, UDLO.CAL 


ALLO 


UDLO.OBJ, I 


AS 


2, UDLO.OBJ 


AS 


3, PR: 


ST 





Load CAL/16 

Assign LU 1 to source input 

Assign LU 2 to object code output 
Assign LU 3 to print device 
Start assembly 
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The sysgen statements are prepared for CUP/16. These must include a TASK statement for each task in the system. 
Examples: 

TASK 0, UDLO, STARTO, 128, 128, R, COMP 
TASK 1, UDLl, START 1, 140, 128, R, COMP 

On a system with no SVC 7 (DELETE SVCSEVEN) all LU assignments must also be specified. Examples: 

ASSIGN 0, 5, TTY:, 16 
ASSIGN 0,3, PR:, 12 

Each OS module (Executive, File Manager and Command Processor) is assembled with the CUP output, as normal. Tasks 
are built in with the system at system generation. 

Example of commands to TET/16 to build system: (2 tasks) 



ESTAB 

IN 

ED 

IN 

IN 

IN 

IN 

IN 

IN 

IN 

IN 

IN 

ED 

IN 

BU 

MAP 

AM 

END 



OS 

EXEC 16 

DLIB16 

FMGR16 

CMDP16 

UDLO 

PORTO 

GETSTRO 

UDLl 

PORTIA 

FORTIB 

GETSTRl 

FTNRTL 

SYS 

OS,OS16FORT.005 

PR: 



EstabUsh OS 
Include Exec 
Edit Drivers 
Include File Manager 
Include System Initialization 



Include second task 



Include library routines for all tasks 
Include dynamic system space 
Build system 
Print maps 



Terminate 



The system can now be bootloaded from the disc. 

FORTRAN programs which are overlayed and/or reference common blocks must be established by TET/16 and not built 
directly into the system. The system must be configured with the SVC 6 image loader. For each established task to be 
loaded (at run-time) there must be a dummy task of equivalent size (including the UDL and get storage areas) built into the 
system and preset Dormant. An additional control task must be coded and preset Ready, so that it will begin executing 
when the system is loaded. This task then dynamically loads each established task into memory. 

Run-time library routines for all FORTRAN tasks may be edited in after all tasks are linked in. They do not require a 
separate partition. 
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CHAPTER 3 
SYSTEM COMPONENTS AND PACKAGING 



PACKAGING CONTENTS 

The OS/16-MT2 Package, S90-010, consists of three major components: documentation, source program modules, and 
functional program modules. Object program listings of OS/ 16 are not provided, since a listing is generated by the 
SYSGEN assembly procedure. The OSI16MT2 Packaging Information Document (09-063M95) outlines the exact contents 
of each package. 



Functional Program Package Description 

STARTER is a preSYSGENed OS/ 16 MT2 system designed to provide the support necessary for the user to perform a 
System Generation (SYSGEN). Three versions of STARTER are provided. 



STARTER 1 



This system contains support for a Teletype (ASR), CRT or Carousel, High Speed Paper Tape 
Reader/Punch, Line Printer, Card Reader, Cassette, and 800 BPI and 1600 BPI Mag Tape. No 
direct access support is included. STARTER 1 should be used only if no Disc facihties are 
available. 



STARTER2 



This system contains, with one exception (no cassette), the support included in STARTERl, 
plus direct access support for 2.5, 10, and 40 MB Discs with both contiguous and Indexed 
File support. STARTER2 is overlayed and requires a disc to run. 



STARTER3 



This system offers the same hardware support as STARTER2. It differs in that it is not 
overlayed and therefore: 

1 . It does not require a disc to run. 

2. It occupies significantly more memory. 

It is intended as a 'back-up' system, useful for: 

1. Building an overlayed system onto a disc. 

2. Running Disc Integrity Check. 

3. Running Disc Compress. 



Two additional pre-sysgened systems are provided for program development and OS/16 system generation: 

DEVELOPMENT SYSTEM 1 for Floppy Systems 

DEVELOPMENT SYSTEM 2 for Disc Systems 
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DRIVER 
LIBRARY 



CUP/ 16 



TET/16 



This loader format object library contains the drivers necessary to support the standard 
peripheral devices. Two driver libraries are provided, one for extended memory systems (more 
than 64KB) and one for non-extended memory systems. There is one driver module for each 
device code defined for OS/16 MT. For more information, see Chapter 4 for use of the Driver 
Library during System Generation. 

The OS/ 16 MT2 Configuration Utility Program (CUP/ 16) is a program which enables the user 
to tailor an OS/ 16 MT system to a particular configuration through SYSGEN statements. See 
Chapter 4 for information on generating a system. 

The OS/16 MT2 TASK ESTABLISHER (TET/16) is required to establish any foreground task 
or re-entrant library before it can be loaded by the OS/ 16 MT2 resident loader. For complete 
information on TET/16, see the OS/16 MT2 Operator's Manual, Chapter 5. 



The utilities provided are designed to allow the user to perform the basic functions necessary for developing systems and 
application programs. The utilities included and their functions are: 



16-BIT 

RELOCATING 

LOADER 



OS/ 16 

LIBRARY LOADER 



The REL Loader is a stand-alone program which is used to load object programs into memory. 
In particular it is used to load a non-overlayed OS/16 from magnetic tape, cassette or paper 
tape. For complete information on the REL Loader, see the 16-Bit Loader Description 
Manual. The OS/16 MT2 Operator's Manual, Chapter 2 discusses the use of the REL loader to 
load an OS/ 16. 

The Library Loader executes under OS/16 control and is used to manipulate object modules 
and libraries of object modules. For complete information on the Library Loader, see the 
16-Bit Loader Description Manual. 



OS/16 DIRECT 
ACCESS BOOT 
LOADER 

OS/ 16 BOOTSTRAP 
PUNCHER 



CAL/16 



DISC 

INTEGRITY CHECK 



DISC 

COMPRESS 



OS EDIT 



The Boot Loader is a stand-alone program used to load OS/ 16 in image format from a Disc 
volume. For complete information, see the OS/ 16 MT2 Operator's Manual, Chapter 2. 

This program executes under OS/ 16 control and is used to produce a memory image format of 
a program suitable for loading by the 50-sequence. For information see the OS/16 MT2 
Operator's Manual, Chapter 2. 

CAL/16, a functional subset of CAL, the Common Assembly Language assembler, provides a 
machine level language for OS/16 MT2 user programs. For complete information on CAL/16, 
see the Common Assembler Language User's Manual. 

This program executes under OS/ 16 control and is used to restore Disc volumes to a valid state 
following a system crash. For complete information, see the Disc Integrity Check Description 
in the OS/16 MT2 Operator's Manual. 

This program executes under OS/ 16 control and is used to provide a dump capability from 
Disc to Disc, Tape to Disc or Disc to Tape. For complete information, see the Disc Compress 
Description in the OS/16MT2 Operator's Manual. 

This program executes under OS/ 16 control and is used to manipulate ASCII and object 
modules. For complete information, see OS EDIT User's Manual. 



I OS/ 16 EDIT 
OS COPY 

AIDS/ 16 



This program is a disc-based version of OS EDIT. See OS/1 6 Edit User's Manual. 

This program executes under OS/16 control and is used to copy files from one medium to 
another. For complete information, see the OS COPY Utility Program Description. 

This program executes under OS/ 16 control and is used to provide debugging capabilities for 
user programs in an OS/16 environment. For complete information, see the AIDS/16 User's 
Guide. 



SOURCE 
UPDATER 



This program operates under OS/ 16 control and is used to provide source program 
development and maintenance capabilities. For complete information, see the Source Updater 
Program Description. 



OS/1 6 HIGH LEVEL This package consists of CSS routines that enable the user to perform common OS/ 1 6 

OPERATOR COMMAND Command sequences with one command. This package is oriented towards a Disc based 
PACKAGE system. For complete information, see the OS/16MT2 Operator's Manual, Chapter 14. 
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MEDIA 

OS/ 16 MT2 is available on three distinct media; Magnetic Tape, Cassette, and Disc. On Magnetic Tape, and Cassette the 
components of OS/16 MT2 are provided as specified in the contents listing included with the Tapes or Cassettes. On Disc, 
the components are provided as files on the Disc as specified by the Directory listing supplied with the Disc volume. Table 
3-1 Usts the available packaging options with the physical media required by each. 

TABLE 3- 1 . OS/ 1 6-MT2 MEDIA PACKAGES 



PACKAGE 


MEDIA 


NUMBER/SIZE 


S90-010-26 


CASSETTE 


1 300' CASSETTE 


S90-010-36 


MAGNETIC TAPE (800 BPI) 


1 2400' TAPE 


S90-0 10-49 


CARDS (SEE NOTEI 


12 BOXES 


S90-010-56 


2.5MB DISC 


1 REMOVABLE CARTRIDGE 


S90-010-66 


10MB DISC 


1 REMOVABLE CARTRIDGE 


S90-0 10-76 


MAGNETIC TAPE (1600 BPI) 


1 2400' TAPE 


S90-010-86 


FLOPPY DISC 


12-13 FLOPPYS 



NOTE 

Source package only available on cards. The functional program 
package must be ordered on another medium. 



In addition to the object format versions of the OS/ 16 Direct Access Boot Loader and 16-Bit REL Loader provided with 
the OS/16-MT2 package, a copy of each of these loaders should be obtained on Magnetic Tape or Cassette, if necessary for 
the specific configuration. 



Please note that STARTER 2 
overlayed and requires a disc. 



not available on a magnetic tape or cassette package. This STARTER system is fully 
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CHAPTER 4 
SYSTEM GENERATION 



CONFIGURATION UTILITY PROGRAM (CUP/ 16) 

The source statements necessary to tailor an OS/16 MT2 system to a particular configuration are produced by the OS/16 
MT2 Configuration Utility Program (CUP/16) in response to configuration statements input to it. The output of CUP/16 is 
then merged with the source modules during the SYSGEN assemblies. The object module output from the SYSGEN 
assemblies are then linked together with the necessary Drivers and any user added modules to produce an OS/ 16 MT2 load 
module (refer to Figure 2-1). This chapter describes the SYSGEN procedure including CUP/16 input and operation, 
SYSGEN assemblies, and linking the system. 

General Principles of Operation 

CUP/ 16 takes a series of configuration statements as input. Each statement may be printed as it is read in order to produce 
a copy of the configuration statement sequence. An END statement is used to terminate the program. CUP/16 produces a 
file of output source SYSGEN statements. This file is then input to the CAL Assembler during a SYSGEN assembly. 

If an I/O error occurs during configuration statement processing, a message is logged and CUP/ 16 pauses. The I/O error 
may then be corrected and CUP/ 16 continued. All non-I/O errors cause an error message to be logged on the console and 
on the CUP/ 16 list device; CUP/ 16 continues processing SYSGEN commands. When an error occurs, the user may correct 
and re-enter the statement before CUP/ 16 processes an END statement. 

Environment 

Memory - CUP/16 requires 7 KB of memory, in addition to that required by the operating system. No additional memory 
is required during execution. 

Devices-CUP/16 requires an input device capable of reading ASCII and an output device supporting ASCII Writes. If a 
listing is desired, an additional device capable of supporting ASCII Writes is required. 

Logical Units - CUP/ 16 uses 3 Logical Units. These are: 

LU 1 Configuration statement input 

LU 2 SYSGEN source output 

LU 3 Configuration statement and error listing 

Listing may be suppressed by assigning LU 3 to the NULL device. 

A typical set of LU assignments is: 

LU 1 Card Reader 
LU2 A Disc File 
LU 3 Line Printer 

CUP/16 may also be run under OS/32 for performing OS/16 sysgens. A 32-bit object is provided with the OS/16 package. | 

CONFIGURATION STATEMENTS 
Syntax 

Configuration statements are read from Logical Unit 1. A copy of these statements is output to Logical Unit 3. 

Configuration statements may be input in any order; all statements are optional and defaults exist for each statement. 
Appendix 4 contains a list of all statements and the defaults associated with each. The default values are the recommended 
values in the absence of any overriding factors. 

If a statement is entered more than once, the last value entered is the accepted value. Only one statement may be entered 
per input record. 

The general format of a configuration statement is: 

VERB Operand or Operands 
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The verb must appear at the beginning (first character position) of a statement record. A verb may be abbreviated by an 
unambiguous substring of its initial characters. 

For example, the verb UNITS may be abbreviated as follows: 

U 

UN 
UNI 
UNIT 

The minimum required characters for each verb are underlined in the descriptions which follow. 

The notation [ ] is used to indicate an optional operand. 

Wherever one blank is permitted, multiple blanks arc permitted. Leading zeros may be omitted in all numeric operands, 
whether decimal or hexadecimal. All SYSGEN statements must end with a blank or a carriage return. Characters present in 
a record following the blank or carriage return which terminates the final operand are ignored. This permits comments to 
be placed on any configuration statement. A statement with an asterisk in the first position is treated as a comment and is 
copied to the list device. 

Example: *OS/16 SYSGEN 3/1/77 

Errors 

'ITie possible error responses to any statement are: 

CMND-ERR Statement verb not recognized. 
COMA-ERR Comma missing or out of place 
TERM-ERR Statement does not end with a blank or carriage return. 

Additional error responses are listed with each statement description, as appropriate and are summarized in Appendix 5. 

If an I/O error is detected on a Read or Write operation, the following error message is output; 

I/O-ERR XX LU = lu 

where XX is the returned SVC 1 error status in hexadecimal as defined in the 08/16 MT2 Programmer's Reference Manual 
and lu is the Logical Unit in error. CUP/16 then pauses. If the operator chooses to resume the program by entering the 
command CONTINUE, the erroneous I/O operation is retried. 

CONFIGURATION (SYSGEN) STATEMENT DESCRIPTION 

The configuration statements are summarized in Figure 4-1 (see Index for page number references). 



CONFIGURATION 




STATEMENT 


FUNCTION 


ASSIGN 


Assign Logical Unit to an I/O Device 


CLOCK 


Specify Line Frequency Clock Dei/ice 


CWIDLEN 


Specify Length of Command Input Buffers 


CONSOLE 


Define Console Device 


CSS 


Specify Number of CSS Levels 


DATE 


Select Date Format (U.S. or European) 


DELETE 


Delete System Module 


DEVICE 


Define Peripheral Device 


DFLOAT 


Specify Double Precision Floating Point Support 



Figure 4-1 Summary of CUP/16 Functions 
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CONFIGURATION 
STATEMENT 



FUNCTION 



END 

EXTMEM 

FLOAT 

FOREGRND 

FREQ 

HALTIO 

INTERVAL 

JOURNAL 

LOGLEN 

LOGQUE 

MBUS 



Terminate CUP/16 

Specify Support for Extended Memory 

Specify Single Precision Floating Point Support 

Specify Nunnber of Foreground Partitions 

Specify Line Frequency Clock Frequency 

Specify Halt I/O Support 

Specify Precision Interval Clock Resolution 

Specify Number of Journal Entries 

Define Length of Log Buffers 

Define Number of Log Buffers 

Specify console device or microbus 



MEMPROT 


Specify Memory Protect Controller Device 


OVCMD 


Specify System Overlays; Command Processor 


OVSEVEN 


Specify System Overlays; SVC 7 


OVSiX 


Specify System Overlays; SVC 6 and 5 


OVTWO 


Specify System Overlays; SVC 2 


PCLOCK 


Specify Precision Interval Clock Device 


PROC 


Define Processor Type 


ROLL 


Specify Roll Out/Roll In Support 


ROUND 


Specify Round Robin Scheduling 


SAFE 


Include Software System Safety Checks 


ST 


Specify a Single-Task Development System 


TASK 


Define a Task if no Command Processor 


UNITS 


Specify Maximum Number of Logical Units Per Task 


VOLUME 


Specify Default System Volume 



Figure 4-1. Summary of CUP/16 Functions (Continued) 
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HARDWARE RELATED CONFIGURATION STATEMENTS 

Processor 

The PROC statement specifies which Processor model is configured in the system. This information is needed to determine 
which software traps must be included in the OS. The format of the statement is: 

PROCn 

where n is described in Table 4-1 . 

TABLE 4-1 . PROCESSOR SPECIFICATION 



PROCESSOR 



SOFTWARE 
TRAPS INCLUDED 



MODELS 70, 80, 85, 7/16 W/HSALU, 5/16, 8/16 

WITH MULTIPLY/DIVIDE 

MODELS 74, 7/16 WITH MULTIPLY/DIVIDE, 6/16 WITH 
MULTIPLY/DIVIDE 

MODELS 7, 16 BASIC, 6/16 BASIC 
MODEL 8/16 BASIC 



NONE 

LIST 

LIST, MULTIPLY/DIVIDE 
MULTIPLY/DIVIDE 



If this statement is omitted, PROC is assumed. 
Possible error response is: 

OPND-ERR n not 0, 1 , 2, or 3 
Single Precision Floating Point 

The FLOAT statement specifies that the target system is to contain single-precision hardware or software Floatingpoint 
support. 

The format is 

FLOAT n 

where n is described in Table 4-2. 

TABLE 4-2. SINGLE PRECISION FLOATING POINT SPECIFICATION 



MEANING 



NO SINGLE PRECISION FLOATING POINT SUPPORT DESIRED 

SINGLE PRECISION SOFTWARE TRAPS FOR MODELS 74, 6/16, 7/16 BASIC, 5/16, 
8/16W/OFPH/W 

SINGLE PRECISION HARDWARE ON MODELS 70, 80. 85, 7/16W/HSALU 
FLOATING POINT HARDWARE ON MODEL 8/16 



If this statement is omitted, no support is included. This statement must be specified if single precision floating point 
instructions are to be used by any task. 

Possible error response is: 

OPND-ERR n not 0, 1 , 2 or 3 

Double Precision Floating Point 

Tlie DFLOAT statement specifies that the .target system is to contain double-precision hardware or software fioafing point 
support. 

The format is: 

DFLOAT n 

where n is described in Table 4-3. 
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TABLE 4-3. DOUBLE PRECISION FLOATING POINT SPECIFICATION 



MEANING 



No Double Precision Floating Point Support Desired 

Double Precision Software Traps for all Models Except 8/16 with DPFP H/W 

Double Precision Hardware on Model 8/16 with DPFP H/W 



If this statement is omitted, no support is included. This statement must be specified if double precision floating point 
instructions are to be used by any task. 

Possible error response is: 

OPND ERR n not 0, 1 or 2 

A summary of processor related statements is shown on Table 4-4. 

TABLE 4-4. SUMMARY OF PROCESSOR RELATED STATEMENTS 







VALUES FOR FLOATING POINT SUPPORT 
SET TO FOR NO SUPPORT DESIRED 


PROCESSOR MODEL 


PROCn 


FLOAT n 


DFLOATn 


70 





2 


1 


80 





2 


1 


85 





2 


1 


7/16W/HSALU 





2 


1 


74 


1 




1 


7/16 with MULTIPLY/DIVIDE 


1 




1 


6/16 with MULTIPLY/DIVIDE 


1 




1 


7/16 BASIC 


2 




1 


6/16 BASIC 


2 


1 


1 


8/16 WITH DPFP AND SPFP H/W 
and SPFP H/W 





3 


2 


8/16 WITH SPFP H/W 





3 


1 


5/16 





1 


1 


8/16 BASIC 


3 


1 


1 


8/16 WITH MULTIPLY/DIVIDE 





1 


1 
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Device and Console Description 

The DEVICE statement specifics the peripheral devices to be configured in the system. Its format is: 
DEVICE dcod, dn, dm 



[[■['ili'lif [^i.j] 



The CONSOLE statement is used to define llic system console device. Its format is; 

CONSOLE dcod,dn,dm 
The individual fields of the above statements have the Ibllowing definitions: 

— dcod is the device code, in decimal, of the device, optionally containing leading blanks. A device code must be a 
number found in the table in Appendix 3. 

— dn is the device number (physical address), in hexadecimal, of the device. 

— dm is the device mnemonic, the name by which the device is to be known to the system. It must be composed of 
from one to four characters followed by a colon. The first character must be alphabetic; the remaining char- 
acters, if any, must be alphanumeric. Each device mnemonic must be unique. 

— selch is the device number (physical address) in hexadecimal, of the Selector Channel to which the device is 
attached. This operand is only required for devices attached to the Selector Channel. 

— ctl is the device number (physical address), in hexadecimal, of the Disc Controller to which the device is 
attached. This operand is only required for Disc devices. 

— ext code is a decimal number used to further define an ITAM/16 communication line. It specifies, for a 
bisynchronous line: master/slave operation, line code, line protocol, and buffering. For an asynchronous line: 
line code, line protocol, and clock selection is specified. For further information refer to the ITAM/16 User's 
Manual (required parameter). 

— reel is the logical record length in decimal to be used for an ITAM/16 BISYNC communications line (device 
codes 161-171). For further information, refer to the /TMA//^ 6 User's Manual. 

— drive* is for floppy disc only and specifies the floppy drive number. It must be a number from to 3. For 
configuring devices to be used with HASP/16, see the description of the DEVICE statement in the HASP/16 
User's Manual, 

For configuring devices to be used with HASP/16, see the description of the DEVICE statement in tht HASP/ 16 User's 
Manual 



The MBUS 
format is: 



MBUS 



ciiicMi speciiics thai the console device is on a microbus (an option on the Model 5/16 processor) Its 

NOTES 

1. If a teletype is the console device the TTY punch is not 
supported. To include support for the reader, enter two 
CONSOLE statements as in Example 1 below. 

2. If the teletype is not the console device and support for the 
reader/punch is required, enter two DEVICE statements as in 
Example 2 below. 

3. A device on a PASLA interface must be set for Full Duplex 
operation with no parity. For strapping information refer to 
M47-102 PASLA Instruction Manual, Installation Specification 
02-279, Section 4.1. 

Examples of Device Configurations 

Example 1 

Tlie user's hardware environment consists of: 

A Card Reader 

A Line Printer (200 LPM) 

A Model 33 ASR Teletype (to be used as the Console device) 

An INTERTAPE Cassette Transport, containing (wo Cassette Drives. 



The configuration statements are: 

CONSOLE 16,2,CON: 
CONSOLE 81. 2.CONR: 
DEVICE 96,4,CR: 
DEVICE 11 2, 62. PR: 
DEVICE 66,45,C AS 1: 
DEVICE 66,55,CAS2: 



Console TTY,dn=X'2' 
Console TTY Reader,dn=X'2' 
Card Reader,dn=X'4' 
200 LPM Printer,dn=X'62' 
Cassette #l,dn=X'4S' 
Cassette #2,dn=X'55' 
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Example 2 

The user has a hardware environment consisting of the following: 

One non-editing CRT, device number 1 0, to be used as console. 
Two M33 ASR Teletypes, device number 2 and 12. 
One 400 CPM Card Reader, device number 4. 
One 200 LPM Printer, device number 62. 
One Selector Channel, device number FO, on which are: 
One Magnetic Tape Controller, controlling 

Two Magnetic Tapes (800 BPI), device numbers 85 and 95. 
One Disc Controller, device number B6, Controlling 
Two 2.5 Mbyte removable Discs, C6 and D6. 

The configuration Statements are: 

CONSOLE 18,10,CON: Console CRT 

DEVICE 16,2,TTY1: M33 ASR TTY #1 

DE VI CE 8 1 , 2 ,TRP 1 : Reader/Punch 

DEVICE 16,12,TTY2: M33 ASR TTY #2 

DEVICE 81,1 2,TRP2 : Reader/Punch 

DEVICE 96,4,CR: 400 CPM Card Reader 

DEVICE 1 1 2,62,PR: 200 LPM Printer 

DEVICE 64,85,MAG1:,F0 Magtape # I 

DEVICE 64,95,MAG2:,F0 Magtape #2 

DEVICE 49,C6,DSC1:,F0,B6 2.5 Mbyte Disc #1 

DEVICE 49,D6,DSC2:,F0,B6 2.5 Mbyte Disc #2 

Possible error responses,are: 

OFLO-ERR More than 128 DEVICE statements were encountered, more than 4 Selector Channels con- 
figured in the system; more than 4 Magnetic Tape Controllers configured in the system. 

DMNE-ERR The dm field is syntactically incorrect. 

DEVN-ERR dn, selch, or ctl is an invalid physical device number. 

CODE-ERR dcod is an invalid device code. 

MULT-ERR The same device mnemonic was specified for more than one device. 

Logical Units 

The Units statement specifies the number of Logical Units available to each partition. This must be a number between I 
and 64, inclusive. Note that the maximum LU number is one less than the number of Logical Units, since LU is a valid 
Logical Unit. It is recommended that a value of 10 or more be used, as certain INTERDATA-supplied programs require 
Logical Units 1 through 9. Its format is: 

UNITS n 
where n is a number from 1 to 64 inclusive. 

If no UNITS statement is found, the default value is 10. 

Possible error response is: 

OPND-ERR n<l or n>64 
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Default Volume 

The VOLUME statement is used to specify the initial system default volume. Its format is: 

VOLUME voln: 

where voln is any volume identifier of one to four alphanumeric characters starting vifith an alphabetic. If no VOLUME 
statement is entered, tlie default consists of four blanks. (This is not a legitimate volume identifier and must be corrected 
by the console operator after system initialization.) 

Possible error response i.s: 

DMNE-ERR Volume name has invalid syntax. 

I 

Halt I/O Support 

The ability to cancel an outstanding 1/0 and proceed request to an interactive terminal device is requested through the 
HAl TIO statement. Its format is; 

HALTIO 

The Halt 1/0 Command (an SVC 1 function) is supported on: 

- TTY keyboard/printer, reader/punch 

- Carousel keyboard/printer, reader 

- CRT/GDT 

If the statement is omitted, Halt I/O is not supported. Without the ability to Halt I/O, an outstanding read request must be 
satisified before any other I/O can be started on that device. 

Assigning Logical Units 

The ASSIGN statement is used to assign a task's logical units at the time when the OS is configured. This feature is 
especially useful for small dedicated applications environments, since it allows the user to delete OS modules that perform 
run time I/O assignments. 

The format of this statement is: 

ASSIGN tn.lu,dm,dcod 

where: tn is the task number in decimal and refers to the lowest task in memory, 1 to the next task, etc. in 

address order, tn must be less than or equal to the value of FOREGRND. 

lu is the logical unit to be assigned to decimal, lu must be less than the value of UNITS. 

dm is the device mnemonic, dm must be previously defined in a DEVICE statement. 

dcod is the device code, in decimal. See Appendix 3 for a list of device codes. 



The ASSIGN statement should only be used for systems with no File Manager (i.e., no SVC 7 support). If the File Manager 
module is included in the system, any assignments preset through CUP/ 16 are automatically closed during the system 
initialize phase. 

Note that with no file management the ASSIGN statement can assign devices and bare discs only. 

Examples: ASSIGN 0,1 ,CR:,96 Assign logical unit 1 of the background partition to the card reader. 

AS 2,3,DSC1 :,51 Assign logical unit 3 of foreground task 2 to the removable platter of the 10 MB disc. 

Possible error responses arc: 

OPND-ERR tn or lu is not valid. 

DMNE-ERR dm is syntactically incorrect or not previously defined in a DEVICE statement. 

CODE-ERR dcod is not a valid device code. 
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Memory Protect 

Tlie MEMPROT statement indicates that the memory protect controller is configured in the system. Its format is: 

MEMPROT dn 
where dn is the device number in hexadecimal of the controller. 
If this statement is omitted no memory protection support is included. 
Possible error response is: 
OPND-ERR dn is an invalid device number 

Example: MEMPROT AE 



Clock Support 

Universal Clock support is included and defined by the CLOCK and FREQ statements (Line Frequency clock), and the 
PCLOCK and INTERVAL statements (Precision Interval clock). Their formats are: 

CLOCK dnl 
FREQ f 
PCLOCK dnp 
INTERVAL n 

where n is a decimal number from to 4095 specifying the supported resolution of the Precision Interval Clock (PIC) in 
milliseconds. The symbol dnl is the device number in hexadecimal, of the Line Frequency Clock (LFC) and dnp is the 
device number of the Precision Interval Clock (PIC), also in hexadecimal. The symbol f specifies the line frequency of the 
line Frequency Clock in Hertz; it must have a value of 50 or 60. If n is 0, no precision interval clock support is included. 
The default for n is (no precision interval clock support). The default for f is 60. 

Possible error response is: 

OPND-ERR Invalid device number, line frequency, or number of milliseconds specified. 

Examples: 

CLOCK 6D 
FREQ 60 
PCLOCK 6C 
INTERVAL 100 

Extended Memory 

The EXTMEM statement is required if the OS is to support more than 64KB. The format of the statement is: 
EXTMEM 

Single Task Development System 

The ST statement specifies a single-task (background only) system. The format of the statement is: 
ST 

It reduces the average OS size by deleting user parameter address checking and file management access privilege and key 
checking. The saving is approximately 500 bytes. All file assignments are Shared-Read-Write (SRW). 



29-431 R03 1/78 '^"^ 



Date 

Since the current date is commonly expressed in one way in tlie United States and another in Europe, the DATE statement 
selects the format the target system should use. 

The format of this statement is: 

DATEn 
where n is either 

for MMDDYY 
or 1 for DDMMYY 

If tills statement is omitted, MMDDYY format is assumed (0). 
Possible error response is: 

OPND-ERR nnotOorl. 



TASK RELATED CONFIGURATION STATEMENTS 

Foreground 

The FOREGRND statement specifies the number of foreground partitions to be configured in the system. The format of 
the statement is: 

FOREGRND n 

where n is a decimal number from to 1 25. A value of 0, specifies a background only system. 

If the FOREGRND statement is omitted, the defauft is 0. 

Possible error response is 

OPND-ERR n>125 

Scheduling 

The ROUND statement specifies round-robin scheduling. Its format is: 

ROUND 

Tasks are scheduled on a priority basis. If this statement is omitted, tasks within one priority level are scheduled according 
to partition number. If round-robin scheduling is specified, the order of scheduling for tasks within one priority level is 
rotated each time one of the tasks relinquishes control of the system. 



Task Specification 

On a system with no Command Processor, each task must be defined at system generation. The TASK statement is of the 
format: 



TASK tn,TASKID,XFER4p,mp: 



|^j[,opt [,opt] ...] 
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where: tn 



the task number in decimal. refers to the lowest task in memory, 1 to the next etc. in address order. 



tn must be less than or equal to the value of FOREGRND. 
TASKID = 1 to 6 character ENTRY symbol at start of task's UDL. 
XFER = 1 to 6 character ENTRY symbol at task's starting location, 
ip = initial task priority, 

mp = maximum task priority. 

R 

or 
D 

opt 



Ready or Dormant. 

option given by one of the following mnemonics: 



ET Executive task 

PL Single Precision Floating Point 

DEL Double Precision Floating Point 

RES Resident 

COMP Old SVC parameter blocks; make compatible 



By default a task is considered as: 
User task 
No floating point 
Non-resident 
Not roUable 

Having OS/ 16 MT2 SVC parameter blocks 
Arithmetic fault pause 



This statement must be entered for every task built into the system at system generation. 
Possible error responses are: 

OPND-ERR tn or R/D specification is illegal 

PRIO-ERR ip or np is illegal 

OPTN— ERR opt mnemonic is illegal 

COMA— ERR comma missing or out of place 

TERM— ERR terminator is illegal 



Examples: 



TASK 
TASK 



0,TASKID,START,128,80,R,RES,FL 
1 ,TASKDM,TASKDM,1 28, 1 28,D 
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FEATURES REQUIRING DISC SUPPORT 

System Overlays 

The use of system overlays is specified by the following four statements. No operands are required. 

OVCMD overlay all Command Processor routines 

OVSHVKN overlay all SVC 7 and Command Processor 

OVSIX overlay all SVC 6, SVC 5, and Command Processor 

OVTW O - overlay all SVC 2 (except 2,23) and Command Processor 

Roll 

Roll support is specified by the ROLL statement. Its format is; 

ROLL 
If this statement is omitted, roll support is not included in the system. 



MODULE DELETION 

Deleting Modules 

The DELETE command is used to remove unneeded modules from the system. Its format is: 
DELE TE option 

BULKSTOR 
I CONTIG 

CMPROC 

DEBUG 

DIS P 
I INDEX 

INITIAL 

LDBG 

LOAD 

MULDV 

OPTIONS 

PFREC 

SETL OG 

SVCFIVE 

SVCSE VEN 

SVCSI X 

SVCTWO 

I Table 4-5 lists which functions may be deleted, and the approximate number of bytes saved by each mnemonic. 

Possible error response is: 

DELE-ERR Invalid DELETE option 
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TABLE 4-5. FUNCTION DELETION 



FUNCTION DELETED 


APPROXIMATE 

NO. BYTES (DECIMAL) 


STATEMENT 


COMMAND SUBSTITUTION SYSTEM (CSS) 


2000 


OMIT CSS STATEMENT 


CLOCK SUPPORT; SET TIME, DISP TIME 
COMMANDS; SVC, 2 CODES 8, 9, and 23 


200 


OMIT CLOCK STATEMENT 


JOURNAL SUPPORT 


100 


OMIT JOURNAL STATEMENT 


SAFETY CHECKS 


1U0 


OMIT SAFE STATEMENT 


ROLL IN/OUT SUPPORT 


300 


OMIT ROLL STATEMENT 


FOREGROUND SUPPORT; TASK COMMAND 


1000 


OMIT FOREGRND STATEMENT 


INDEXED FILE SUPPORT 


1000 


DELbIb INDEX 


DISC SUPPORT: ALLOC, DELETE, 
FILES, INITIALIZE.SAVE, CLEAR, AND 
VOLUME COMMANDS; SVC 7 FILE MAN- 
AGEMENT SUPPORT 


4000 


OMIT DISC DEVICE STATEMENTS 


SET PARTITION COMMAND 


100 


OMIT FOREGRND 

AND DISC DEVICE STATEMENTS 


HALT I/O SUPPORT 


250 


OMIT HALTIO STATEMENT 


BULK STORE COMMANDS (RW, FF, FR, 
BF, BR) 


100 


DELETE BULKSTOR 


COMMAND PROCESSOR MODULE 




DELETE CMPROC 


EXAMINE, MODIFY AND BIAS 


200 


DELETE DEBUG 


DISPLAY COMMANDS 


1200 


DELETE DISP 


SYSTEM INITIALIZATION CODE AFTER 
SYSTEM IS INTIALIZED 


500 


DELETE INITIAL 


RESIDENT OBJECT CODE LOADERS 


750 


DELETE LDBG 


SVC 6 IMAGE LOADER 


850 


DELETE LOAD 


SOFTWARE EMULATION OF M/D 
INSTRUCTIONS IF NOT REQUIRED BY 
THE OS ITSELF 


340 


DELETE MULDV 


OPTIONS COMMAND 


100 


DELETE OPTIONS 


POWER FAIL RECOVERY 


250 


DELETE PFREC 


SET LOG COMMAND 


200 


DELETE SETLOG 


SVC 5 (OVERLAY LOADER) 


100 


DELETE SVCFIVE 


FILE MANAGER MODULE 




DELETE SVCSEVEN 


ALL SVC 6, IMAGE LOADER, 
OVERLAY LOADER 


1500 


DELETE SVCSIX 


SVC 2 (GENERAL SUPERVISOR 
SERVICES) 


1280 


DELETE SVCTWO 


EXTENDED MEMORY SUPPORT 


2000 


OMIT EXTMEM STATEMENT 


CONTIGUOUS FILE SUPPORT 


1000 


DELETE CONTIG 



NOTE: The number of bytes saved applies to non-overlayed systems only. 
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OPERATOR RELATED CONFIGURATION STATEMENTS 
Command Substitution System 

The CSS Statement sets the maximum nesting depth fisr Command Substitution System (CSS) calls. Its format is: 

CSSn 

where n is any number from to 16. 

If is specified, CSS support is not included in the system. Maximum nesting depth refers to the number of CSS files that 
can be active at any one time. If the statement 

CSS 1 

is entered, then the target system gives the user the capability of calling CSS files from the console, but these files may not 
call other CSS files; if the statement 

CSS 2 

had been entered, then files called from the console could call other files, but these in turn could not make further calls, 
and so forth. 

A level of 2 is sufficient to support the OS/ 16 High Level Operator Command Package. 

The default value for the CSS statement is 0; i.e., no CSS support included in the system. 

Possible error response is: 

OPND-ERR n>16 

Command Buffer Length 

The CMDLEN statement sets the length of the system command buffer (or command buffers, if CSS is present). Its format 
is: 

CMDLEN n 

where n is an even decimal number from 32 to 124 inclusive. 

Note that, although the maximum line length of the system console device may be 72 or 80 bytes, a greater buffer length 
may be desirable because of CSS, There are two considerations: 

- Commands may be read from devices or files with a greater record length; 

- Argument substitution may cause lines, once read in, to be expanded, as in the following example: 

If this statement is omitted, the default value is 64. 

A value of 72 is sufficient to support the OS/16 High Level Operator Command Package. 

Possible error response is: 

OPND-ERR n<32 or n> 1 24 or n not a multiple of 2 

Log Message Buffer Length 

The LOGLEN statement sets the maximum size of the. Log Message buffer. Messages logged by tasks executing under the 
system being configured, that are longer than the specifi:ed lengths are truncated to n. Its format is: 

rOGLEN n 

I where n is an even decimal number between 32 and 1 16 inclusive. 

If this statement is omitted, the default value is 48. 

Possible error response is: 

OPND-ERR n<32 or n> 1 1 6 or n not a multiple of 2 
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Message Logging 

The LOGQUE statement specifies tlie number of console messages that may be queued within the system. Its format is: 

LOGQU E n 

where n may be a decimal number from 1 to 16. If the LOGQUE command is omitted, a value of 3 is assumed. 

Possible error response is; 

OPND-ERR n<lorn>16 

Journal 

The System Journal is a list of historical data, maintained by the operating system primarily for system debugging, each 
entry consisting of five halfwords of information. The JOURNAL statement indicates the number of journal entries within 
the system. 

The format of this statement is; 

JOURNAL n 

where n is the number of entries required, a positive number < 52. 

If this statement is omitted, no Journal is included in the system. 

Possible error response is; 
OPND-ERR n>51 

Safety Checks 

The SAFE statement indicates that internal, logical safety checks are to be included with the system. The format of the 
statement is: 

SAFE I 

The default, if this statement is omitted, is no safety checks. 

Terminating CUP/ 16 

The END statement is used to terminate CUP/ 16 processing. Its format is; 
END 

OPERATING INSTRUCTIONS 

Tlie following procedure should be used to perform a SYSGEN with CUP/16 under an OS/16 MT2 STARTER. 

Load CUP/ 16 

CUP must be loaded with the LDBG command of STARTER 

LDBG fd 
where fd is the file descriptor of the device or Disc File containing CUP/ 1 6. 

Start CUP/ 16 

CUP/ 16 Logical Unit assignments must be made with the ASSIGN command, and CUP/16 started with the START 
command. When started, CUP/16 logs the message CUP/16 and SYSGEN statements are read from LU 1. When the END 
statement is processed, CUP/ 16 terminates with an END OF TASK message. The output should be saved for the SYSGEN 
assemblies. 

CUP/16 may also be run under OS/32. The 32-bit object program provided with the package (CUP 1632.0BJ) must be I 
established as a task under OS/32. ■ 
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Examples of CUP/ 16 Operation 
Non-Disc System: 

LDBG PTRP: 
ASSIGN l,CON; 
ASSIGN 2,PTRP: 
ASSIGN 3,NULL: 
START 



Disc System : 



VOLMT16 

ALLOCUPOUT.1,80 

SET PART SYS/HOOO 

LDBG CUP.OBJ 

AS 1,CR: 

AS 2,CUPOUT 

AS3,PR; 

START 



Load CUP from the Paper Tape Reader 
Statement input on the Console TTY 
Source output on the Paper Tape Punch 
No List output 



Set default system volume 

All(x.ate CUP output file 

Set partition 

Load CUP from Disc File CUP.OBJ 

Assign CUP input to the Card Reader 

Assign source output to Disc F'ile CUPOUT 

Assign list output to the Printer 



THE SYSGEN ASSEMBLIES 

After the user has configured a system with CUP/16, the next step in the process is the SYSGEN assembly. Three 
assemblies are required for System Generation. The modules to be assembled are components of the OS/16 MT2 Source 
Program Package: 

OS/ 16 MT2 Hxecutivc 

OS/ 16 MT2 File Manager 

OS/ 16 MT2 Command Processor 

Instructions for assembling each source module are the same. The user begins by loading the CAL/16 assembler with the 
background loader in STARTER. 



LDBG MAGI: 
LDBG CALI6D.OBJ 



Examples: 

CAL/16 Logical Units must now be assigned to the devices or files containing the appropriate information: 



Load CAL/16 from mag tape 
Load CAL/16 from a Disc File 



Example 1 (Non-Disc System) 



ASSIGN 


l.CR: 


ASSIGN 


2,PTRP: 


ASSIGN 


3,PR: 


ASSIGN 


4,MAG1 


ASSIGN 


7,PTRP: 



Example 2 (DISC System) 



ALLO 


EXEC16.0BJ,IN 


ASSIGN 


1,EXEC16.CAL 


ASSIGN 


2,EXEC16.0BJ 


ASSIGN 


3,PR: 


ASSIGN 


7, CUPOUT 


ALLO 


SYM,IN,2S6 


ALLO 


MRG,IN,256 


ASSIGN 


6,SYM 



A.ssign the source module input to LU 1 (Card Reader) 
Assign the object module output to LU 2 (Paper Tape Punch) 
Assign the list device to LU 3 (Line Printer) 
Assign a scratch device to LU 4 (Mag Tape) 
Assign the source SYSGEN output of CUP to LU 7 
(Paper Tape Reader) 



Allocate a file for the assembly's object output. 

Assign the OS/ 16 source module to LU 1 (Disc File) 

Assign the object module output to LU 2 (Disc File) 

Assign the list device to LU 3 (Line Printer) 

Assign the source SYSGEN output of CUP to LU 7 (Disc File) 

Allocate and assign assembler work files 



ASSIGN 



8,MRG 



NOTE 

The scratch unit (LU 4) should be assigned only if the scratch 
feature is being used. For example, scratch should not be used if the 
source modules are on Disc. 
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Once the correct units have been assigned and the devices are ready, CAL/16 is started with the START command. The 
user should enter: 

START for non-scratch assemblies where source input is rewindable, or 

START,PPAUS for non-scratch assemblies where source input is not rewindable, or 

START,SCRAT for scratch assemblies. 

For non-scratch assemblies specifying PPAUS, CAL/16 pauses. In this case, reposition the source input and the CUP output 
to the beginning and use the CONTINUE command to resume the assembly. 

When the assembly is complete, an END OF TASK message is printed. All source modules are assembled using the above 
procedure. By not reassigning LU 2 between assemblies, the user can output all the object modules onto a single file to be 
used for the linking process. In this case, each assembled module must be referenced by name (program label) if the system 
is established by TET/16. If the OS/ 16 MT2 Source Program Package is supplied on Cassette, CAL pauses at the end of 
each tape to allow mounting of the next tape. The CONTINUE command is used to resume the assembly. 

LINKING THE SYSTEMS 

Two procedures are available for linking the OS/ 16 object modules. For Non-Disc Systems, the OS/ 16 Library Loader is 
used to build an OS/16 load module. For Disc Systems, the OS/16 Task Establisher (TET/16) is used. The OS/16 Library 
Loader may also be used to build a Disc System, but no generation of system overlays is available with the Library Loader. 

The load module output by the Library Loader is an absolute loader format object program. The 16 Bit Relocating Loader 
is used to load this output. The load module output by TET/16 is a memory image file (usually a contiguous Disc File), 
which must be loaded by the OS/ 16 Direct Access Boot Loader. 

NON-DISC SYSTEMS 

The user begins by loading the OS/ 16 Library Loader with the background loader in STARTER. The following sample 
sequence shows the build process performed using Paper Tape. Any device supporting binary Read/Write can be substi- 
tuted. For further details on OS/ 16 Library Loader operation, see the 16-Bit Loader Description Manual. 

* 

LDBG PTRP: Load the Library Loader from the Paper Tape Reader 
Assign the object module input device to LU 1, the load module output device to LU 2, a list device to LU 3, and the 
command input device to LU 5: 

ASSIGN 1,PTRP: Paper Tape Reader 

ASSIGN 2,PTRP: Paper Tape Punch 

ASSIGN 3,PR: Line Printer 

ASSIGN 5,CON: Console 

Start the Library Loader. 

START 

The message 'LOADER' is logged on the console. Instruct the loader to output a load module on LU 2. 

OUT 2 Set output to Paper Tape Punch 

Set the load module origin to 0. 

BIASO 
Load the OS/ 16 MT2 Executive Object Module. This module must be first. 

LO 1 Read from the Paper Tape Reader 

Link in the OS/ 1 6 MT2 File Manager object module. 

LI 1 

Place the correct OS/16 MT2 Driver Library (extended or non-extended memory version), contained in the OS/16 MT2 
Functional Program Package, in the input device. The drivers and subroutines required for the user's configuration are 
selected by the Library Loader EDIT command. If the OS/ 16 MT2 Functional Program Package is on Magnetic Tape or 
Cassette, use the RW command to rewind the device before editing. 

ED 1 
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Link in tlie OS/16 MT2 Command Processor object module. This module must be last. 

LI 1 
Terminate the load module build operation. 

XOUT 
Obtain a MAP of the module. 

MAP 3 
Exit from the Library Loader. 

END 

The resulting absolute OS/ 16 load module may be loaded with the 16-Bit Relocating Loader. See the OS/ 16 MT2 
Operator's Manual for instructions on loading the OS. 



DISC SYSTEM 

The user begins by loading the OS/16 Task Establisher (TET/16) with the background loader in STARTER. The following 
sample sequence shows the build process performed using Disc Files. Any device supporting binary Read/Write can be 
substituted. For further details on Task Establisher Operation, see the 0SI16 MT2 Operator's Manual. 

LDBG TET.OBJ Load TET/16 from a Disc File 

Assign TET Logical Units: 

ASSIGN 4,SCRAT.OBJ Assign LU 4 (scratch unit) to a Disc scratch file. 

ASSIGN 5,CON: Assign LU 5 (rET/16 command input) to the console. 

ASSIGN 7,CON: Assign LU 7 (TET/ 1 6 error message output) to the console. 

Start TET/16 
START 

TET logs the message TET/16 00-00 and reads the following commands from the device assigned to LU 5. 

Specify OS establishment to TET: 

ESTA OS 

Include the assembled object modules: 

INCLUDE EXEC16.0BJ Load the OS/ 16 modules from the Disc Files output by CAL. 

INCLUDE FMGR 1 6.0BJ Executive must be first. 

Edit the OS/ 16 MT2 Driver Library to include the necessary drivers. 

EDIT DLIB16.0BJ (or EDIT DLIB16EX.0BJ for an extended memory system) 

Link in any user-written drives. 

INCLUDE USERDRV.OBJ 

INCLUDE CMDP16.0BJ Include command processor. This module must be last. 
Build the OS load module to a Disc File. 

BUILD OS.fd Build to a Disc File 

The file name fd should not exist at the time of the BUILD command so that TET/16 can allocate the correct amount of 
space. TET/16 also allocates enough space for, and builds system overlays to, the specified file if required. 

Obtain a MAP of the system on the line printer. 

MAP PR: 
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Exit from TET/ 16 
END 

The resulting OS/ 16 MT2 load module may be loaded with the OS/ 16 Direct Access Boot Loader. See the OSI16 MT2 
Operator's Manual for instruction on loading the OS. 

The file name fd should not exist at the time of the BUILD command so that TET/16 can allocate the correct amount of 
space. TET/16 also allocates enough space for, and builds system overlays to, the specified file if required. The fd should 
be of the form OS16xxxx.nnn, where xxxx is up to four optional characters, and nnn is three hexadecimal digits. 

If the Executive, File Manager and Command Processor object code modules are output to the same file, individual 
modules must be included by program label. 

As an example, assign LUs 4, 5 and 7 as above, start TET/16 and enter: 



ESOS 

INOS16.0BJ,EXEC16 

EDDLIB16.0BJ 

IN0S16.0BJ, FMGR16 

IN0S16.0BJ,CMDP16 

BUOS,OS16MT2.00A 

MAP PR: 

AM 

END 



Establish Operating System 
Executive list 
Drivers as required 
File Manager 
Command Processor last 
Build to disc file 
Map in address order 
Map in alphabetic order 
Exit from TET/16 



SYSTEMS WITH NO COMMAND PROCESSOR 

If the Command Processor is deleted as a SYSGEN option, all tasks must be built in with the system at system generation. 
The order of system modules and user tasks is as follows: 



Executive 

Drivers 

File Manager 

Command Processor 

TaskO 

Task 1 



(must be first) 

(edited from driver library) 

(contains only system initialization code; must be last OS module) 
(as defined in TASK statement) 



Task n 
.SYS 



(Tasks must be in order, as defined in TASK statements) 

(Dummy program with ENTRY symbol .SYS to define start of dynamic 

system space. This task has a transfer address of X'60'.) 



Non-Disc Systems 

Example using Library Loader: 



TOP 


FCOO 


Allow room for REL loader 


OUT 


2 


Prepare to output module to LU 2 


BIAS 





Start at zero 


LOAD 




Load Exec from LU 1 


EDIT 




Edit drivers 


LINK 




Link in File Manager 


LINK 




Link in Command Processor 


LINK 




Link in Task 


LINK 




Link in Task 1 


LINK 




Link in dummy program .SYS 


XOUT 




Complete Load Module 


MAP 


3 


Obtain a system map 


END 




Exit from Library Loader 
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Disc Systems 


Example 


using TET/I6: 


ES 


OS 


INCL 


EXEC.OBJ 


EDIT 


DL1BI6.0BJ 


INCL 


FMGR.OBJ 


INCL 


CMDP.OBJ 


INCL 


TASKO.OBJ 


INCL 


TASK 1. OB J 


INCL 


TASK2.0BJ 


INCL 


TASK3.0BJ 


INCL 


SYS.OBJ 


BUILD 


OS,OS16MINI.004 


MAP 


PR: 


END 





Establish OS 

Include Exec 

Edit drivers 

Include File Manager 

Include Command Processor 

Include Tasks in order 



Include dummy program to define start of dynamic system space 
Build OS onto disc 
Obtain system map 
Exit fromTET/I6 



CONFIGURATION EXAMPLES 
Example of Program Development System 



CONSOLE 


16,2,CON: 




DEVICE 


80,1.?,FTRP: 




DEVICE 


51,C6,DSC1; 


,F0,B6 


DEVICE 


50,C7,DSC1: 


,F0,B6 


DEVICE 


%,4,CR: 




DEVICE 


114,62,PR: 




DEVICE 


64,85,MAG1 


:,F0 


OVCMD 






OVSEVEN 






OVTWO 






DELETE SVCFIVE 




DELETE SVCSIX 




CSS 2 






DELETE INITIAL 




ST 






END 







Example Of System To Support Basic Level II 

CLOCK 6D 

CMDLEN 80 

LOGLEN 80 

PROC 

FLOAT 2 

ROUND 

FOREGRND 3 

OVCMD 

OVSEVEN 

OVSIX 

OVTWO 

UNIT 10 

DELETE INITIAL 

CONSOLE 16,2,CON. 

CONSOLE 81, 2,CONR: 

DEVICE34,I0,CRT: 

DEVICE tl2,62,PR: 

DEVICE 64,85,MAG1:,F0 

DEVICE 49,C6,DSCI :,F0,B6 

END 
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Example of Real-time System For Europe 

CLOCK 6D 

FREQ 50 

DATE 1 

PC LOCK 6C 

INTERVAL 5 

PROCO 

ROLL 

SAFE 

FOREGRND 4 

UNITS 16 

MEMPROT AE 

OVCMD 

OVSEVEN 

DELETE INITIAL 

HALTIO 

CONSOLE 34, lOCRT: 

DEVICE 80,1 3, PTRP: 

DEVICE 1 14,62,PR; 

DEVICE 64,85.MAG1:,F0 

DEVICE 128,20,LN0 

DEVICE 1 28,21, LNl 

DEVICE 1 28,22,LN2 

DEVICE 1 28,23, LN3 

DEVICE 128,24,LN4 

DEVICE 128,25,LN5 

DEVICE 128,26,LN6 

DEVICE 128,27,LN7 

DEVICE 52,FC,DSC1 :,F0,FB 

DEVICE 51,C6,DSC2:,F0,B6 

DEVICE 50,C7,DSC3;,F0,B6 

END 



Example Of System With Command Processor Deleted (System has an image loader.) 



CLOCK 6D 

PCLOCK 6C 

INTERVAL 100 

PROC2 

FLOAT 1 

DFLOAT 1 

ROUND 

FOREGRND 2 

DELETE CMPROC 

DEVICE 16,2,TTY: 

DEVICE 34,10,CRT: 

DEVICE 64,85,MAG1 ;,F0 

DEVICE 49,C6,DSC1 :,F0,B6 

TASK 0,TASK0,START0,120,80,R,RES 

TASK 1,TASK1,TASK1, 128,128,0 

TASK 2,TASK2,TASK2, 128,128,0 

END 

The Minimum System 

DELETE CMPROC 

DELETE SVCSEVEN 

DELETE SVCSIX 

DELETE SVCTWO 

DELETE MULDV 

DELETE PEREC 

PROCO 

UNITS 1 

DEVICE 16,2,TTY: 

TASK 0,TASKID,START,128,128,R 

ASSIGN 0,0,TTY:, 16 

END 
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CHAPTER 5 

OS/16 MT2 COMPATIBILITY 

WITH OTHER OPERATING SYSTEMS 



INTRODUCTION 

The question of software compatibility between OS/16 MT2 and other INTERDATA operating systems is multi-faceted 
and must be discussed with regard to separate areas: 

SVC Compatibility 

File Compatibility 

Operator Command Compatibility 

Memory Management Compatibility 

Driver Compatibility 

SVC COMPATIBILITY 

There are two aspects of SVC compatibility: one is the functions provided by the SVCs; the other is the abiUty to write 
source level statements which can be translated to work the same way under different operating systems. Table 5-1 illus- 
trates the functional compatibility between OS/16 MT2 SVCs and those of other INTERDATA operating systems. 

At the source level OS/ 16 MT2 is upwards compatible from earlier 16-Bit operating systems for functions that are present 
in both. That is for SVC 1, SVC 2 Code 1 through Code 7, SVC 3, the SVC call and parameter block may be coded in 
exactly the same way for any 16-Bit operating system except for SVC 1 random calls. Random addresses are 4 bytes in 
OS/16 MT2 and 2 bytes in other 16-Bit operating systems. OS/16 MT2 is a compatible subset of OS/32 MT. Since 
addresses and constants are different lengths in a 16-Bit or 32-Bit environment, the calls and parameter blocks are not 
exactly the same. Using CAL common mode instructions, the SVC calls and parameter blocks may be coded so that they 
can be assembled for execution under either OS/ 16 MT2 or OS/32 MT. Table 5-2 compares SVC parameter block format 
between OS/ 16 MT2 and OS/32 MT. 

There are several differences in SVC support between OS/16 MT2 and OS/32 MT that are not covered in the previous 
general discussion. These are; 

1. SVC 6 - OS/ 16 MT2 task queues have halfword entries. There are no reason codes on task queue 
entries as in OS/32 MT. However, if reason codes are ignored under OS/32 MT, a program could be 
written to run on either OS. 

2. OS/ 16 MT2 does not contain SVC 2 code 10 and 11 support since SVC 2 code 23 can be used to 
support all SVC 2 code 10 and 1 1 functions. 

3. OS/ 16 MT2 SVC 2, Code 23 allows one active time interval per task as opposed to an unlimited 
number in OS/32 MT. 

In summary, a task may be written to run under OS/16 MT2 and any other 16-Bit operating system by only using the 
common functions. A task may be written to run under OS/ 16 MT2 and OS/32 MT by choosing OS/ 16 MT2 functions, 
using CAL common mode instructions only, and coding the SVC parameter blocks as in Table 5-2. SVC 1 parameter blocks 
written for older 16-Bit operating systems must be recoded to have the 4 byte random address and 2 byte length of 
transfer fields; otherwise OS/ 16 MT2 returns length of last transfer to locations outside the parameter block. The SVC 1 
compatibility option may be specified for a task, in which case DOS/BOSS/RTOS SVC 1 parameter block format is 
assumed. 
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TABLE 5-1 . SVC COMPATIBILITY 



"^^ OS 

SVC \. 
NUMBERS. 


BOSS 


DOS 


RTOS 


OS/32MT 


OS/16MT2 


1 


NOTE 1 


NOTE 1 


NOTE 1 


Y 


Y 


2 1CODE 


Y 


Y 


NOTE 2 


Y 


Y 


2 


Y 


Y 


Y 


Y 


Y 


3 


Y 


Y 


Y 


Y 


Y 


4 


Y 


Y 


Y 


NOTE 2 


NOTE 2 


5 


NOTE 3 


NOTE 3 


NOTES 


NOTES 


NOTES 


6 


Y 


Y 


Y 


NOTE 2 


NOTE 2 


7 


Y 


Y 


Y 


NOTE 2 


NOTE 2 


8 


N 


N 


Y.NOTE 2 


Y 


Y 


9 


N 


N 


Y 


Y 


Y 


10 


N 


N 


Y 


Y 


N 


11 


N 


N 


Y 


Y 


N 


12 


IM 


N 


Y 


N 


N 


13 


IM 


N 


Y 


IM 


N 


14 


N 


N 


Y 


N 


N 


15 


N 


N 


N 


Y 


Y 


16 


N 


N 


N 


Y 


Y 


17 


N 


N 


N 


Y 


Y 


18 


N 


N 


N 


Y 


Y 


19 


N 


N 


N 


Y 


Y 


23 


N 


N 


N 


Y 


Y 


3 


Y 


Y 


Y 


NOTE 2 


NOTE 2 


4 


N 


Y 


N 


N 


N 


5 


N 


Y 


NOTE 2 


NOTE 2 


NOTE 2 


6 


N 


N 


NOTE 4 


NOTE 5 


NOTE 5 


7 


N 


N 


N 


Y 


Y 


8 


N 


N 


, Y 


N 


N 


9 


N 


N 


N 


Y 


Y 


10 


N 


N 


Y 


N 


N 


14 


N 


N 


N 


Y 


N 


15 


N 


N 

1 


N 


Y 


N 



NOTES 



N Operating system does not support this SVC. 
Y Operating system supports this SVC. 



1. SVC 1 parameter blocks written for OS/16 MT2 may be used for non-random I/O. Or SVC 1 compatibility option must be specified for task. 

2. Additional options provided. 

3. SVC is executed compatibly but the constant table differs as described in the discussion in this chapter on Memory Management. 

4. DOS SVC 6 totally incompatible. 

5. Functionally different from earlier OS SVC 6. 
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TABLE 5-2. PARAMETER BLOCK COMPATIBILITY 



SVC 



OS/16 MT2 



OS/32 MT 



SVC 1 
I/O 



SVC 2 CODE 1 
Pause 

SVC 2 CODE 2 
Get Storage 



SVC 2 CODE 3 

Release Storage 



SVC 2 CODE 4 
Set Status 



SVC 2 CODE 5 
Fetch Pointer 



SVC 2 CODE 6 
Unpack 



SVC 2 CODE 7 
Log Message- 



SVC2 CODE 8 

Interrogate 

Clock 



SVC2 CODE 9 

Fetch Date 



OPT 



DEST ADDRESS 





7 8 15 





FC 


LU 


2 


DIS 


DDS 


4 


START ADDRESS 


6 


END ADDRESS 


8 


RANDOM ADRS 


2 


SIZE OF LAST XFER 









00 


01 









OPT 


02 j 


2 


REGISTER NO. 


4 


NO. OF BYTES 









00 


03 


2 


NO. OF BYTES ! 






OPT 


04 


2 


NEW PSW STATUS 









00 


05 1 


2 


REGISTER NO. 











OPT 


06 j 


2 


DEST ADDRESS ] 






OPT 


oH 


2 


LENGTH 


4 


TEXT 













OPT 


08 


2 


BUFFER ADDRESS | 



09 








7 


8 


15 







FC 


LU 




2 


DIS 


DDS 




6 


- 


START ADDRESS 


- 




8 


- 


END ADDRESS 


- 




12 


- 


RANDOM ADRS 


- 




14 
16 

18 


- 


SIZE OF LAST 
XFER 


- 











00 




01 














OPT 


02 1 




2 


REGISTER NO. 




4 
G 


- 


NO. OF BYTES 


- 

















00 


03 




2 


fill 




4 
6 


- 


NO. OF BYTES 


- 

















OPT 




04 




2 


NEW PSW STATUS 

















00 


05 




2 


REGISTER NO. 











OPT 


06 




2 


fill 




4 
6 


- 


DEST ADDRESS 


- 















OPT 




07 




2 


LENGTH 






4 
6 


TEXT 















OPT 


08 




2 


fill 




4 
6 


- 


BUFFER ADDRESS 


- 











OPT 




09 




2 


fill 




4 
6 


- 


DEST ADDRESS 







CAL CODE 



ALIGN ADC 

DB FC, LU 

DC H '0' 

DC A (START) 

DC A (END) 

DC Y 'RANDOM' 

DS ADC 

NOTE 
DIS = Device I ndependent Status 
DDS = Device Dependent Status 

ALIGN ADC 
DBO.I 

ALIGN ADC 
DB 0PT,2 
DCH'REG' 
DC A (SIZE) 



ALIGN ADC 
DB0,3 
DAC SIZE 



ALIGN ADC 

DB 0PT,4 

DC X'STATUS' 

ALIGN ADC 

DB0,5 

DCH'REG' 



ALIGN ADC 
DB OPT,6 
DAC DEST 



DIRECT TEXT 
ALIGN ADC 
DB 0PT,7 
DC H'LENGTH' 
DC C'TEXT' 



ALIGN ADC 
DB 0PT,8 

DAC BUFFER 



ALIGN ADC 
DB 0PT,9 

- DAC DEST 



INDIRECT TEXT 
ALIGN ADC 
DB 0PT,7 
DC H'LENGTH' 
DC A(TEXT) 
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TABLE 5-2. PARAMETER BLOCK COMPATIBILITY (Continued) 



SVC 



SVC 2 
CODE 15 



OS/16 MT2 





7 


8 


15 





OPT 


15 


2 


REGISTER NO. 



OS/32 MT 






7 


8 


15 


OPT 


15 


REGISTER NO. 



ALIGN ADC 
DB0PT,15 

DC H'REG' 



SVC 2 
CODE 16 






OPT 


,e| 


2 


REGISTER NO. 


4 


DEST ADDRESS 






OPT 


__ «H 


2 


REGISTER NO. 


4 
6 


- 


DEST ADDRESS 


- 



ALIGN ADC 
DB 0PT,16 
DC H'REG' 
DC A (DEST) 



SVC 2 
CODE 17 









17 


2 


REG1 


REG2 


4 


MNEM TABLE ADD. | 









17 


2 


REG1 


REG2 


4 
6 


- 


MNEM 
TABLE ADDRESS 



ALIGN ADC 

DB0,17 

DB REG1,REG2 

OCA (MNEMTB) 



SVC 2 
CODE 18 






OPT 


18 


2 


REG1 


REG2 


4 


ECSTRING ADDRESS 






OPT 


18 


2 


REG1 


REG2 


4 
6 


ECSTRING 
ADDRESS 



ALIGN ADC 

DBOPT,18 

DB REG1,REG2 

DC A (ECSTRING) 



SVC 2 
CODE 19 









19 


2 


NLU 


MPRI 


4 

6 

8 

10 


OSID 


12 
14 
16 
18 


TASK ID 


20 


CTSW 


22 


TASK OPTIONS 


24 


WAIT STATUS 









19 


2 


NLU 


MPRI 


4 

6 

8 

10 


OSID 


12 
14 
16 
18 


TASK ID 


20 
22 


CTSW 


24 


TASK OPTIONS 


26 


WAIT STATUS 



ALIGN ADC 
DB 0,19,0,0 
DS 22+ADC 



SVC 2 
CODE 23 






OPT 


23 


2 


REGISTER NO. 


4 
6 


TIME 


- 






OPT 


23 


2 


REGISTER NO. 


4 
6 


- 


TIME 


- 



ALIGN ADC 
DB OPT,23 
DC H'REG' 
DC Y'TIME' 



SVC 5 



- 


OVERLAY 


- 


- 


NAME 


— 


— 




" 


STAT 


OPT 


LU 












2 


- 


OVERLAY 


— 


4 


- 


NAME 


" 


6 


"" 




" 


8 


STAT 


OPT 1 


10 


LU 



ALIGN ADC 
DBC'OVLYNM' 
DBC ' 
DB 0,OPT 
DC H'LU' 
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TABLE 5-2. PARAMETER BLOCK COMPATIBILITY (Continued) 



SVC 6 




2 
4 
6 


TASKID 


8 
10 


FUNCTION CODE 


12 


TASK STATUS 


14 


ERROR STATUS 


16 


LOAD LU 


PRIORITY 


18 


RPRI 


RESERVED 


20 


START ADDRESS 


22 
24 


DELAY TIME 


26 
28 


DEVICE 
MNEMONIC 


30 


PARAMETER 


32 
34 
36 


MESSAGE BUFFER ADDRESS 

RESERVED 
(4 BYTES) 




2 

4 
6 


TASKID 


8 
10 


FUNCTION CODE 


12 


TASK STATUS 


14 


ERROR STATUS 


16 


LOAD LU 


PRIORITY 


18 


RPRI 


RESERVED 


20 
22 


START ADDRESS 


24 
26 


DELAY TIME 


28 
30 


DEVICE 
MNEMONIC 


32 
34 


PARAMETER 


36 
38 


MESSAGE BUFFER 
ADDRESS 


40 


RESERVED 
(8 BYTES) 



ALIGN ADC 

DCC'TASK ID' 

DC Y'FUNCTION' 

DS4 

DB LU 

DB PRIORITY 

DS2 

DAC START 

DC Y'TIME' 

DC C'DEVM' 

DAC PARM 

DAC MESS 

DS ADC*2 



SVC 7 





2 

4 

6 

8 

10 

12 

14 

16 

18 

20 

22 

24 

26 



CMD 


MOD 


STAT 


LU 


WKEY 


RKEY 


LRECL 


- 


VOLN 


- 


FILENAME 


- 


E 


XT 




RESERVED 


- 


SIZE 





2 

4 

6 

8 

10 

12 

14 

16 

18 

20 

22 

24 

26 



CMD 


MOD 


STAT 


LU 


WKEY 


RKEY 


LRECL 1 


- 


VOLN 


- 


FILENAME 


- 


E! 


<T 




RESERVED 


SIZE 



ALIGN ADC 

DB CMD.MOD 

DS1 

DBLU 

DC H 'KEYS' 

DC H'LRECL' 

dcc'voln" 
dcc'filename' 

DC C'EXT' 
DC F'SIZE' 
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FILE COMPATIBILITY 

File compatibility must be discussed from two aspects, volume portability and program compatibility. Program 
compatibility means that a program can be written which can be executed using the different file types with the same 
results. In this respect, OS/ 16 MT2 Contiguous files and Indexed files are program compatible with each other. The 
BOSS/RTOS file structures and the DOS Direct Physical-Access file structure are program compatible with the OS/ 16 MT2 
Contiguous file. The OS/ 16 MT2 Indexed file is nearly, but not completely, program compatible with BOSS/RTOS and 
with DOS Non-Direct Physical- Access file structures. The primary differences are: 

Indexed files are fully open-ended 

Indexed file has a fixed length record (as in DOS) 

Indexed files do not support filemark operations 

Volume portability means that a file created on direct access volume under one operating system can be read under 
another operating system. 

File compatibility is illustrated in Table 5-3. 



TABLE 5-3. FILE COMPATIBILITY 

Inle Structure 





BOSS 


DOS 


RTOS/ 
OS/16MT 


OS/ 16 MT2 


OS/32 ST 


OS/32 MT 


Contiguous 

Chained 

Indexed 


Y 

N 
N 


Y 

N 
N 


Y 

N 
N 


Y 

N 
Y 


Y 

Y 

N 


Y 
Y 
Y 







Volume Portability 






Written 


Read Under | 


BOSS 


I50S 


OS/16MT 


0S/16MT2 


OS/32 MT 


Under 






RTOS 




or M 1 


BOSS 


Yes 


No 


Note 1 


No 


No 


DOS 


Note 2 


Yes 


Note 2 


No 


No 


RTOS-OS/16 












MT 


Yes 


No 


Yes 


No 


No 


OS/16MT2 


Note 3 


No 


Notes 


Yes 


Yes 


OS/32 MT 












or ST 


Note 3 


No 


No 


Yes 


Yes 



NOTES 

1 • A file written under BOSS can be read under RTOS only if it 
is allocated on cylinder boundaries. 

2. A DOS file can be read under BOSS or RTOS only if it con- 
tains no overflow cyhnders. 

3. An OS/32 or OS/16 MT2 file can be read under BOSS only if it 
is a Contiguous file. 

OPERATOR COMMAND COMPATIBILITY 

In general the structure of Operator Commands is not compatible between OS/16 MT2 and OS/32 MT on one hand, 
and the other 16-Bit operating systems, on the other hand. Table 5-4 shows Operator Command syntax for commands 
which are functionally similar. (Note, each OS may have other commands not shown in the table). The only significant 
differences between OS/ 16 MT2 and OS/32 MT are: 

OS/ 16 MT2 supports a $ELSE command. 

The syntax of the SET PARTITION command is different. 

Additional commands support the ROLL, System Overlay and background loader features. 

OS/ 16 MT2 has a FILES command in place of the DISPLAY FILES command in OS/32 MT. 
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TABLE 5-4. OPERATOR COMMAND SYNTAX COMPATIBILITY 



FUNCTION 


BOSS 


DOS 


RTOS 


OS/32-MT 1 


OS/16 MT2 


Allocate file 


AL xpa,ssss,eeee 


AL NNNNNN,lupa,ccc 


ALLO fnpa,ssss,eeee,wprp 


AL fd,ft,size,keys 


Assign file 


AS lu,xpa 


ACNNNNNN.Iupa 


ASSIGN taskid.lu.pa 


AS iu,fd,ap,keys 


Initialize Pack 


SApa 


PA pa.A 




N/A 


dm.voln.options 


Set file Attributes 




AC NNNNNN.Iupa 








Delete file 




DENNNNNN 


RELEfnpa 


DEfd 


Close 




CL 




CI lu 


List file 


LEpa 


LI lu [pal 


LIST pa 


Dl F voln: 


Fl «oln: 


Run program from file 




RUNNNNNN [,pal 








Assign logical unit 


AS lu,pa 


AS lupa[,lupa. . . .] 


ASSI TASKID,lu,pa[ lu.pa] 


AS lu,fd,ap,keys 


Set bias 


Bl xxxx 1 




Bl xxxx 


Load a program (task) 


LOpa 


LOlu 


LOAD TASKID.pa 


LTASKID,fd,nj LOTASKID.fd 


Start a program (task) 


ST [xxxx] 1 


STAR TASKID,pa,TADR,hlimmss 


ST [xxxx] .options 


Halt a program (task) 


HA 


@ 


HALTTASKID 


P 


Cancel a task 






CANCTASKID 


CA 


Delete a task 






DELETASKID 


OPT NON; CA 


Continue a program (task) 


CO 


CONTTASKID 


CO 


Connect a program (task) 






CONN TASKID pa,parm[,...pa,parm] 






Set task options 






OPTI bbbb bbbb bbbb bbbb 


options 


Display logical unit 




LU 


DISP TASKID 


Dl L 


Pass message to task 






TELLTASKID.message 


SEND MSG 


Ser task's priority 






PRIOTASKID,xx 


SET PRI nnn 


Set timeout count 






TOUT TASKID,Oxxx,xxxx 






Set date 






DATE mm/dd/yy 


SET TIME 
mm/dd/yy, hh:mm:ss 


Set time 






TIME hhmmss 


Read date 






RDDA 


Dl TIME 


Read time 






RDTI 


Open memory cell 


OP xxxx 


OPEN xxxx [,xxxx...] 


EX xxxx,n 


Replace memory contents 


RE xxxx 


REPL xxxx.yyyy [,vyyy. . . .] 


MO xxxx. yyyy 


Open preceding cell 


-[n] 


- 








Open succeeding cell 


+ [n] 


+ 








Print system map 






MAP 


Dl MAP 


Protect system 






PROT 






Set TSKCOM size 






TCOM xxxx 


SE PA .TCM 




Backspace record 


BSpa 


BSIu 


BKSP pa 


BRfd 


Backspace file mark 


BFpa 


BFlu 


BSFM pa 


BFfd 


Forward space record 


F.Spa 


FSlu 


FRSP pa 


FRfd 


Forward space file mark 


FFpa 


FF lu 


FRFMpa 


FFfd 


Rewind device 


RWpa 


RW lu 


REWI pa 


REWfdorRWfd 


Write file mark 


WFpa 


WFlu 


WTFM pa 


WFfd 


Transfer command input 


TRIu 




fd 


fd 


Copy file 




CPIu,lu,[dddd,A] 








Position subfile 


PO pa,NNNNNN 


PONNNNNNJu 
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MEMORY MANAGEMENT COMPATIBILITY 

The memory management of OS/16 MT2 is similar to that of OS/32 MT. The salient features of the memory management 
are best illustrated by Table 5-5. The first 4 items are those returned by an SVC 2, Code 5 call by the various operating 
systems. 

TABLE 5-5. MEMORY MANAGEMENT FEATURES 



OS FEATURE 


BOSS/DOS 


RTOS 


OS/32MT 


OS/16MT2 


CTOP 


Y 


NOTE 1 


NOTE 1 


N0TE1 


COMBOT 


Y 


Y 


N 


Y 


UTOP 


Y 


Y 


NOTE 2 


NOTE 2 


UBOT 


Y 


Y 


Y 


Y 


GET/RELEASE 


Y 


Y 


Y 


Y 


EXPAND/ 
CONTRACT 


N 


Y 


NOTE 3 


NOTE 3 


RESERVED 
SYSTEM SPACE 


M 


N 


Y 


Y 


TASKS MAY 
BE LOADED 
ANYWHERE 


Y 


Y 


Y 


Y 



NOTES 

1. CTOP is the last halfword of physical memory in BOSS and 
DOS. It is top of program allocated memory in RTOS, OS/16 and 
OS/32. Top of physical memory is maintained in MTOP for OS/32 
and OS/16 MT2. Size of currently used system space is 
MTOP-FBOT in OS/ 16 MT2. 

2. UTOP is set to the top of the user program. This does not 
reflect the use of task common or library segments. 

3. Expand and contract requests are ignored by OS/32 and OS/16. 



DRIVER COMPATIBILITY 

Driver compatibility must be discussed with regard to functional compatibility and internal compatibility. The following 
OS/16 MT2 drivers are functionally the same as the corresponding OS/32 drivers: 

Teletype 

Line Printer 

Card Reader 

High Speed Paper Tape 

Mag Tape (9 Track) 

Cassette 

Asynchronous CRT/TTY Driver 

Disc 

8-Line Interrupt Module 

Floppy Disc 

!n addition OS/ 16 MT2 provides a Digital Multiplexor and 7 Track Mag Tape Driver not supported in OS/32. OS/ 16 MT2 
drivers are functionally upwards compatible with RTOS drivers. Internally, the OS/16 MT2 driver interface is compatible 
with RTOS drivers. Internally, the OS/ 16 MT2 driver interface is compatible with drivers written to Series 16 Compatible 
Driver conventions. This means that drivers written for RTOS may be linked into an OS/16 MT2 system. 
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CHAPTER 6 
EXTENDED MEMORY SUPPORT 



This chapter describes OS features for support of processors with greater than 64KB and gives examples of extended 
memory environments. It is intended as a guide and should be used with the OSI16MT2 Operator's Manual, Chapters 3 
and 5, which describe the OS SET PARTITION command and the task establishment procedures. 

The basic features of extended memory are: 

- Support for up to 256KB memory 

- n task environments up to 64KB depending upon available memory, 32KB of which is sharable with 
other tasks 

- Maximum task common/sharable library area is 32KB 

All user software currently running under a non-extended OS/ 16 system will run without 
modification. 

- Established and non-established tasks can be loaded anywhere in memory. 

Configuring a System for Extended Memory 

An OS/ 16 system is configured for use on a processor with greater than 64KB by including the EXTMEM sysgen 
statement. 

REFERENCING EXTENDED MEMORY 

The lower 32KB on an extended memory system is referenced by addresses in the range 0-7FFF. The second 32KB module 
is referenced by addresses 8000-FFFF. All additional 32KB modules are also referenced by addresses 8000-FFFF. The user 
prefixes all addresses beyond 64KB with the numbers 1 through 6 to select the correct 32KB module. The following table 
defines OS memory referencing. 

Note, for example, that addresses 10000-1 7FFF do not exist. 

OS Operator Referenced 

Entered Address 32KB Module 

0-7FFF 1st 

8000-FFFF 2nd 

1 8000-1 FFFF 3rd 

28000-2FFFF 4th 

38000-3FFFF 5th 

48000-4FFFF 6th 

58000-5FFFF 7th 

68000-6FFFF 8th 

Additional information on extended memory: 

- System space is always allocated downward from the top of physical memory and can be a maximum 
of 32KB. 

- Partitions may not cross 32KB boundaries with the exception of the first 32KB boundary. 

- A user task anywhere in memory can directly reference task common and/or a sharable Ubrary in 
either the first or second 32KB memory module. 
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The following examples illustrate various applications of extended memory. All examples are systems with 128KB. 
Example 1 . A moderate task common area and user tasks 32KB or less. 



8KB SYSTEM SPACE 



24KB USER TASK 



32KB USER TASK 



16KB USER TASK 



16KB USER TASK 



10KB TASK COMMON 



22KB OS 



2FFFF 
2E000 



32KB MODULE 4 



28000 



1FFFF 



32KB MODULE 3 



18000 



FFFF 



COOO 32KB MODULE 2 



8000 



5800 



32KB MODULE 1 



In this example, the upper 10KB of the lower 32KB module acts as a task common area. It is directly addressable from all 
modules. The OS is SYSGENED for 5 foreground partitions. Foreground partition 1 acts as the task common area. The 
background partition has a size of zero. The SET PARTITION command used in this example is: 

SET PAR l/58OO,2/8OOO,3/COO0,4/18OO0,5/28O0O,.SYS/2EOOO 

In establishing the four user tasks with TET/16, the BIAS commands are BIAS 8000, BIAS COOO, BIAS 18000, and BIAS 
28000. For task common referencing, the TET TSKCOM command is TSKCOM 5800. 
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Example 2. A large background task with several foreground tasks requiring no task common. 



8KB SYSTEM SPACE 



24KB USER TASK 



24KB USER TASK 



8KB USER TASK 



42KB BACKGROUND TASK 



22KB OS 



2FFFF 
2EOO0 



28000 



FFFF 



8000 



5800 



32KB MODULE 4 



1FFFF 



1A000 32KB MODULE 3 



18000 



32KB MODULE 2 



32KB MODULE 1 



The background task extends from the top of the OS up to the first 64KB boundary. The SET PARTITION command 
used in this example is: 

SET PAR 1/18000,2/1 A0O0,3/28000,4/2E000,5/2E000,.SYS/2EOOO 

Note that foreground partitions 4 and 5 have a size of zero. 
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Example 3. Using the second 32KB for task common and a sharablc library. 



8KB SYSTEM SPACE 



24KB USER TASK 



32KB USER TASK 



8KB USER TASK 



8KB TASK COMMON 



16KBSHARABLE LIBRARY 



10KB BACKGROUND TASK 



22KB OS 



2FFFF 
2E000 



28000 



1FFFF 



18000 



32KB MODULE 4 



32KB MODULE 3 



FFFF 
EOOO 

COOO 32KB MODULE 2 

8000 



5800 32KB MODULE 1 



The task common and sharable library partitions in module 2 may be directly referenced by all user tasks. The SET 
PARTITION command in this example is: 

SET PAR l/8000,2/C000,3/E000,4/l 8000,5/28000,. SYS/2E000 

When establishing all user tasks, OPTION CSEG must be specified. It indicates a task common or sharable Hbrary segment, 
in the second 32KB module, is to be accessed by some task outside that module. TET/I6 BIAS commands for the tasks are 
BIAS EOOO, BIAS 1 8000, and BIAS 28000. The TSKCOM and RESOLVE commands are TSKCOM COOO and RESOLVE 
fd,8000. 
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Example 4. A large background area with part of the second 32KB used as a task common segment. 



8KB SYSTEM SPACE 



16KB USER TASK 



8KB USER TASK 



8KB USER TASK 



24KB USER TASK 



4KB TASK COMMON 



38KB BACKGROUND 
TASK 



22KB OS 



2FFFF 
2E000 



2A000 
28000 



1FFFF 
1E000 



18000 



FFFF 
FOOO 

8000 



5800 



32KB MODULE 4 



32KB MODULE 3 



32KB MODULE 2 



32KB MODULE 1 



The SET PARTITION command in this example is: 

SET PAR 1/F000,2/1 8000,3/1 E000,4/28000,5/2AOOO,.SYS/2E00O 

OPTION CSEG must be specified when establishing tasks since they will reference a task common segment in the second 
32KB. The TSKCOM command is TSKCOM FOOO. 
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Example 5. Task common, sharable library and a foreground task in the second 32KB with a large background task. 



8KB SYSTEM SPACE 



24KB USER TASK 



32KB USER TASK 



10KB USER TASK 



4KB TASK COMMON 



4KB LIBRARY 



24KB BACKGROUND TASK 



22KB OS 



2FFFF 
2E000 



28000 



1FFFF 



8000 



5800 



32KB MODULE 4 



32KB MODULE 3 



J 8000 

ffff" 

D800 
C800 



B800 32KB MODULE 2 



32KB MODULE 1 



The SET PARTITION command for this example is: 

SET PAR 1 /B800,2/C8003/D800,4/l 80OO,5/28OO0,.SYS/2E000 

OPTION CSEG must be specified when establishing any task referencing the task common or sharable library partitions. 
The BIAS commands, when estabhshing tasks, are BIAS D800, BIAS 18000 and BIAS 28000. The TSKCOM and RE- 
SOLVE commands would be TSKCOM B800 and RESOLVE fd,C800. 

When establishing a sharable library or task common segment that will reside in the second 32KB module and will be 
accessed by a task outside that module, OPT CSEG must also be specified. In this example: 



ESTABLISH 


RL 


OPTION 


CSEG 


BIAS 


C800 


INCLUDE 


FTNRTL 


BUILD 


RL,FTNRTL.RL 


MAP 




END 
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Example 6. Multi-user BASIC system. 



8KB SYSTEM SPACE 



8KB USER 



8KB USER 



8KB USER 



12KB USER 



iOKB USER 



10KB USER 



8KB USER 



6 KB USER 



18KB BASIC INTERPRETER 



8KB USER 



24KB OS 



2FFFF 
2E000 

2C000 32KB MODULE 4 

2A000 
28000 



1FFFF 
1D000 

1A800 
18000 



6000 



32KB MODULE 3 



FFFF 
EOOO 
C800 32KB MODULE 2 

8000 



32KB MODULE 1 



This system is SYSGENed with 10 foreground partitions. The SET PARTITION commands for this example are: 

SET PAR 1/6000,2/8000,3/C800,4/E000,5/I8000,6/1A800 

SET PAR 7/lDO0O,8/28OOO,9/2AO0O,lO/2C00O,.SYS/2E0OO 
The BASIC interpreter is established as a sharable library as follows: 



ESTABLISH 


RL 


OPTION 


CSEG 


BIAS 


8000 


INCLUDE 


BASIC 


BUILD 


RL.BASIC.RL 


END 





The dummy user tasks (see Chapter 10 of the 0SI16 MT2 Operator's Manual) are established with OPTION CSEG. 
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Example 7. Multiple task commons 



8KB SYSTEM SPACE 



16KB USER TASK 



8KB USER TASK 



4KB TASK COMMON 



8KB USER TASK 



12KB USER TASK 



8KB USER TASK 



12KB USER TASK 



4KB TASK COMMON 



24KB BACKGROUNO TASK 



24KB OS 



2FFFF 
2E000 

2A000 

28000 



6000 



4TH 32KB MODULE 



1FFFF 
1F000 
1D000 3RD 32KB MODULE 

1A000 
18000 



FFFF 

DOOO 

COOO 2ND 32KB MODULE 

8000 



1ST 32KB MODULE 



In tliis example, all tasks access the task common area in the second 32KB module. In addition, the user tasks in the third 
32KB module can access a task common area in that module. 

The SET PARTITION commands are as follows: 

SET PAR l/C0OO/,2/DO0O,3/18OOO,4/lA000,5/lDOO0 

SET PAR 6/lF0OO,7/28OOO,8/2AO0O,.SYS/2EOOO 

OPTION CSEG and TSKCOM COOO should be specified for all tasks. 

Tasks in the third 32KB module can reference task common area in that module by direct references to addresses FOOO - 
FFFF. 
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Example 8. A large task 



8KB SYSTEM SPACE 



24KB USER TASK 



LARGE USER TASK 
(2ND SEGMENT) 



LARGE USER TASK 
(1ST SEGMENT) 



4KB TASK COMMON 



8KB USER TASK 



24KB OS 



2FFFF 



2E000 



28000 



32KB MODULE 4 



1FFFF 



32KB MODULE 3 



18000 



FFFF 



9000 
8000 



32KB MODULE 2 



6000 32KB MODULE 1 



Hie user may take advantage of the sharability of the second 32KB module in order to create up to a 64KB task. In this 
example the task is broken into two segments. The segment in the second 32KB module must be established as a reentrant 
library for the partition at 9000. The second is established as a task for a partition at 18000. The TET RESOLVE 
command is used to satisfy external references between the segments. 

TET commands for establishing the first segment of the large task; 

ESTABLISH RL 

OPTION CSEG 

BIAS 9000 

TSKCOM 8000 

INCLUDE SEGMENTl 

RESOLVE SEGMENT2,8000 

(RESOLVE SEGMENT2,8000,8084 if the second segment specifies OPTION DFLOAT) 

(RESOLVE SEGMENT2,8000,8GOO if the second segment contains its own UDL) 

(RESOLVE SEGMENT2,8000,8044 if the second segment specifies OPTION FLOAT) 

BUILD RL,SEGMENT1.TSK 

END 

TET command for establishing the second segment of the large task: 



ESTABLISH 

OPTION 

BIAS 

TSKCOM 

INCLUDE 

RESOLVE 

BUILD 

MAP 

END 



TASK 

CSEG 

18000 

8000 

SEGMENT2 

SEGMENT 1,9000 

TASK,SEGMENT2.TSK 
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The SET PARTITION command for this example is: 

SET PAR 1/6000,2/8000,3/9000,4/18000,5/28000,.SYS/2EOOO 

All tasks including both large task segments are established using the CSEG option. The 4KB task common area can be 
referenced by all tasks. 



USE OF THE TET/16 CSEG OPTION 

Tliis section describes the use of the CSEG option when establishing a task or re-entrant library. 

OPTION CSEG should be specified when establishing a task only if both of the following conditions are true: 

- The task references a task common or re-entrant library partition in the second 32KB module 
(addresses 8000-FFFF), and 

- that task common or re-entrant partition is referenced by any task partition starting at location 1 8000 
or higher. 

OPTION CSEG should be specified when establishing a re-entrant library or task common data program containing address 
constants only if both of the following conditions are true: 

the library or task common is being established for a partition in the second 32KB module (addresses 
8000-FFFF), and 

- the library or task common is referenced by some task partition starting at location 1 8000 or higher. 

NOTES 

- CSEG is the only option valid for establishing a re-entrant library 
or task common program. All other options are ignored. 

- OPTION CSEG must precede the TSKCOM command when 
establishing a task. 

- OPTION CSEG may not be specified for a task whose partition 
crosses the first 32KB boundary (location 8000). 
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APPENDIX 1 
CONFIGURATION OF OS/16 MT2 STARTER 



Three functional variations of the OS/ 16 MT2 STARTER system are supplied. 

STARTER 1 03-086 FOl is designed for systems configured without direct access devices (Size = 21 KB) 

STARTER 2 03-086 F02 is designed for systems configured with disc devices (Size = 18KB) 

It is overlaid and requires a disc to run. 

STARTER 3 03-086 F03 is a non-overlaid system with disc support (size = 32 KB) 

It does not require a disc to run. 

DEVELOPMENT SYSTEM 1 03-086F07 is a system configured for a Floppy disc (Size=14.5KB) 
DEVELOPMENT SYSTEM 2 03-086F08 is a system configured for a 2.5 or 10MB disc (size=14.5KB) 

See the 08/16 MT2 Packaging Document (04-063M95) for the configuration statements of the starter systems. 



I 
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APPENDIX 2 

RE-CONFIGURING AN 
OS/ 16 SYSTEM 

If the peripheral device numbers or device types assigned in the STARTER system differ from those in the user's 
configuration. It is necessary to manually change these device numbers from the display panel. 

Tlie procedure to modify the console device number is as follows: 

1 . Obtain the address of CNSDCB, the console DCB address, from the MAP of the STARTER system supplied with the 
STARTER programs. 

2. Subtract X'14' from this address. 

3. Modify the halfword at this address to contain X'OOOl " if the device is on a micro-bus; otherwise modify it to contain 
X'OOOO'. 

4. Modify the first Byte of the next halfword to contain the hexadecimal device code of the console device (see appen- 
dix 3). Modify the second Byte of the halfword to contain the new device number of the console device. 

NOTE 

If the console device is on a PASLA interface, no console patches 
are required for the STARTER systems. 

For the remainder of the devices, the procedure is: 

1. Obtain the DCB entry point address from the Map of the STARTER system. Each DCB in the system has an entry 
point name of the form DBmmmm where mmmm is the device mnemonic defined in the STARTER SYSGEN 
parameter. For example, DBPTRP is the DCB associated with the Paper Tape Reader Punch named PTRP: 



2. 
3. 

4. 

5. 



Subtract X'12' from this address. 

Modify the first Byte of the halfword at this address to contain the hexadecimal device code of the device (see 
appendix 3). Modify the second Byte of the halfword to contain the device number of the device. 

Double the device number, add X'DO', and place the DCB address at the resulting location. 

For a disc device the number of sectors per cylinder, sectors per track, optimum increment, and sectors per pack may 
have to be modified. Add X'5E' to the DCB address. Modify 4 halfwords at this address. See table below for standard 
values : 





device code 




disc 


(Hex) 


disc dependent data 


2,5mb 


31 


0030,1804,0000,2610 


lOmbR 


32 


0030,1806,0000,4C80 


lOmbF 


33 


0030,1 806,0000,4C80 


40mb 


34 


0190,1405,0002,7A60 


67mb 


35 


0140,4020,0004,04CO 


256mb 


36 


O4CO,4020,0O0F,454O 



To change the selch device number for a disc or magnetic tape device: 

1 . Obtain the DCB entry point address from the Map of the STARTER System. 

2. Add X'3A' to this address. 

3. Modify the first byte to contain the selch device number. 
To change the controller device number for a disc device: 

1 . Obtain the DCB entry point address from the Map of the STARTER System. 

2. Add X'3A' to this address. 

3. Modify the second byte to contain the controller device number. 
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APPENDIX 2 (Continued) 

Example: 

Consider a configuration with tlie following devices: 

1. Teletype (console device) — device code X'lO' 

device number X'02' 

2. Removable 2. 5mB disc - device code X'31' 

device number X'C6' 

controller device number X'B6' 

selch device number X'FO' 

3. Fixed 2. 5mB disc — device code X'31' 

device number X'D6' 

controller device number X'B6 ' 

selch device number X'FO' 

4. Magnetic tape 1 600 BPI device code X'4r 

device number X'C5' 

selch device number X'Fl' 

Use the OS 16 MT2 Bootstrap Loader to load STARTER 2 from the removable 2.5mB disc. 

1. Modify the console device. Find the address of CNSDCB from the map. Subtract X'14'. 
Change this location to X'OOOO'. 

Change the next location from X'2210' to X'1002'. 

2. Modify the removable disc device from a 5mB disc to a 2.5mB disc. 
Find the address of DBDSCl. Subtract X'12'. 

Change this location from X'33C6' to X'31C6'. 

Also modify the number of sectors per pack. Add X'5E' to the DCB address. 

Change 4 halfwords at this location from 0030, 1 806,0000,4C80 to 0030,1804,0000,2610. 

3. Modify the fixed disc device from a 5mB disc to a 2.5mB disc. Note that for this device the device number also must 
be changed. 

Find the address of DBDSC2. Subtract X'12! 

Change this location from X'32C7' to X'31D6'. 

Add X"5E' to the DCB address. 

Change 4 halfwords at this location from 0030,1806,0000,4C80 to 0030,1804,0000,2610. 

4. Modify the magnetic tape from 800 BPI to 1600 BPI. 

First calculate double the new device number plus X'DO". 2*X'C5' + X'DO' = X'25A'. 

Modify this location X'25A' to contain the address of the DCB, given by DBMAGl on the map. 

Subtract X'l2' from the DCB address. 

Change this location from X'4085' to X'41C5' 

Add X'3A' to the DCB address. 

Change this location from X'FOOO' to X'FIOO' 

Now restart the system. Initialize the machine and address X'60'. Hit EXECUTE or RUN. 
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Setting the time and date on systems with no command processor. 

1. Prepare the ASCII representation of the time and date at which the system will be started. The format 
is: 

hh:mm;ss mm/dd/yy U.S. 

or 

hh:mm:ss dd/mm/yy European 

There are two 'space' characters between the time and date. 



Character or Digit 

ASCII Representation (HEX) 




30 



1 
31 



2 
32 



3 
33 



4 
34 



6 
36 



7 
37 



38 



9 

39 



/ 
2F 



sp 

20 



3A 



2. Prepare the hexadecimal representation of the time as a number of seconds past midnight. The 
following table gives the value on every quarter of an hour: 



-^^ 


-ninutes 








^\^ 


past 








hours 


\^ :00 


:15 


:30 


:45 


00: 


00000000 


00000384 


00000708 


00000A8C 


1: 


OOOOOEIO 


00001194 


00001518 


0000 189C 


2: 


0000 1C20 


0000 IF A4 


00002328 


000026AC 


3: 


0000 2A30 


0000 2DB4 


00003138 


000034BC 


4: 


00003840 


00003BC4 


00003 F48 


000042CC 


5: 


00004650 


000049 D4 


00004D58 


000050DC 


6: 


00005460 


0000 5 7 E4 


00005B68 


00005EEC 


7: 


00006270 


00006 5 F4 


00006978 


00006CFC 


g 


00007080 


00007404 


00007788 


00007B0C 


9 


00007E90 


00008214 


00008598 


000089 IC 


10 


00008CA0 


00009024 


000093 A8 


0000972C 


11 


00009 ABO 


00009E34 


0000 A IB8 


0000A53C 


12 


0000A8C0 


0000AC44 


0000 AFC8 


0000B34C 


13 


0000B6D0 


0000BA54 


0000BDD8 


OOOOCl 5C 


14 


0000C4E0 


0000C864 


0000CBE8 


0000CF6C 


15 


0000D2F0 


0000D674 


0000 D9F8 


0000DD7C 


16 


OOOOEIOO 


0000 E484 


0000E808 


0000EB8C 


17 


0000 EF 10 


0000 F294 


OOO0F618 


0000 F99C 


18 


O00dFD2O 


0001 00 A4 


00010428 


000 107 AC 


19 


0001 0B30 


00010EB4 


00011238 


00011 SBC 


20 


00011940 


00011CC4 


00012048 


0001 23 CC 


21 


00012750 


0001 2 AD4 


0001 2E58 


0001 3 IDC 


22 


00013560 


0001 38E4 


0001 3C68 


0001 3 EEC 


23 


00014370 


0001 46 F4 


00014A78 


00014DFC 



3. Find the address of symbol CBUF from the system map. 

4. Loadsystemasnormal. 

5. Use console panel to store time, date, and seconds past midnight from address of CBUF onwards. 

6. Set up address X'60'. Initialize processor. Restart system at time set. 
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Examples: 



APPEI^DIX 2 (Continued) 



9:00 amjanuary 2nd,1976 
09:00:00 01/02/76 
Hnter the following: 



(U.S. format) 



3039 
3A30 
303 A 
3030 
2020 
3031 
2330 
322F 
3736 
0000 
7E90 



2:30pm,23rd August, 1977 
14:30:00 23/08/77 
Hnter the following: 



(European format) 



3134 
3A33 
303 A 
3030 
2020 
3233 
2F30 
382F 
3737 
0000 
CBE8 



A2-4 



29-^31 ROl 6/76 



APPENDIX 3 
DEVICE CODES 

Device codes to 1 5 are reserved for direct-access file structures and as sucli do not refer to any specific type of device. 

Code Device 

Dec (Hex) 

16(10) M33 Teletype Keyboard/Printer, current loop interface 

17(11) M35 Teletype Keyboard/Printer, current loop interface 

18(12) Nonediting CRT, current loop interface 

20 (14) Graphics Display Terminal, current loop interface 

21 (1 5) Carousel 30 or 35, 80 column, current loop interface 

22 (16) Carousel 30 or 35, 132 column, current loop interface 
34 (22) Non-editing CRT, PALS or PASLA interface, local 

36 (24) Graphic Display Terminal, PALS or PASLA interface, local 

37 (25) Carousel 300, PALS or PASLA interface, local 

38 (26) Carousel 300, w/electronic format, PALS or PASLA interface, local 

48 (30) 2.5 MB Disc, fixed platter 

49 (3 1 ) 2.5 MB Disc, removable platter 
50(32) 10 MB Disc, fixed platter 

51 (33) 10 MB Disc, removable platter 

52 (34) 40 MB Disc 

53 (35) 67MB Disc 

54 (36) 256MB Disc 
55(37) Floppy Disc 

64 (40) 800 BPI Magnetic Tape 

6 5 (4 1 ) 1 600 BPI Magnetic Tape 

66 (42) INTERTAPE Cassette 

67 (43) 7-track Magnetic Tape 

80 (50) High Speed Paper Tape Reader/Punch 

81 (51) M33 Teletype Reader/Punch TTY interface 

82 (52) M35 Teletype Reader/Punch, TTY interface 

83 (53) Carousel 30 or 35 Reader, current loop interface 

96 (60) Card Reader without automatic Hollerith/ ASCII conversion 

97 (61) Card Reader with automatic Hollerith/ ASCII conversion 
1 1 2 (70) 200 LPM Line Printer 

1 14 (72) 600 LPM Line Printer 

128(80) 8-Line Interrupt Module 

129(81) Digital Multiplexor 

136 (88) RTAS Conversion Equipment 

137 (89) RTAS Conversion Equipment (with external clock) 

138 (8A) Mini I/O, Analog Input 

139 (8B) Mini I/O, Analog Output 

140 (8C) Mini I/O, Digital I/O 

145 (91) ASR 33 Teletype Keyboard/Printer, PALS or PASLA interface, Remote 

146 (92) ASR 35 Teletype Keyboard/Printer, PALS or PASLA interface. Remote 

147 (93) Non-editing CRT, PALS or PASLA interface, Remote 

148 (94) Graphic Display Terminal, Remote 

149 (95) Carousel 300 Keyboard /Printer, Remote 

1 50 (96) Carousel 300 with Electronic Formatting, Remote 

160 (AO) BISYNC Communication line (line drive only on 201 DSA) 

161 (Al ) BISYNC Communication IBM 3780 Emulation/201 Adapter 

162 (A2) BISYNC Communication Line IBM 2780 Emulation/201 Adapter 

163 (A3) BISYNC Communication Line Processor Mode/201 Adapter 

168 (A8) BISYNC Communication line (line drive only on QSA) 

169 (A9) BISYNC Communication Line IBM 3780 Emulation/QSA 

170 (AA) BISYNC Communication Line IBM 2780 Emulation/QSA 

171 (AB) BISYNC Communication Line Processor to Processor/QSA 

Device codes 240-254 (FO-FE) are reserved for user-written drivers. 

Device codes 145-171 (91-AB) require the extended device code field in the DEVICE statement. 



29431 R02 6/77 A3-1/A3-2 



APPENDIX 4 
SUMMARY OF CUP/16 CONFIGURATION STATEMENTS 



Statement 


Operands 


Function 


Default 


ASSIGN 


tn.lu.dm.deod 


Assign logical unit to an I/O device 


No assignment 


CLOCK 


dn 


Specify Line Frequency Clock device 


No clock support 


CMDLKN 


n 


Set length of" Command and CSS l)uffers 


64 


CONSOLE 


dcod,dn,dm 


Define Console Device 


16,2,TTY: 


CSS 


n 


Set number of CCS levels 





DATE 


n 


Set U.S. (n=0) or European date (n=l) 


U.S. (n=0) 


DELETE 


option 


Delete a system module 


The module is included 


DEVICE 


dcod,dn,dni 

- selch ^ -] p |- , 
ext codes • . J ^ 
^ drive # J J L L 


Configure a device 




DFLOAT 


n 


Specify Double Precision Floating 
Point support 


No DPFP support 


FLOAT 


n 


Specify Single Precision Floating Point Support 


No SPFP support 


END 




Terminate CUP/ 16 


1 


EXTMEM 




Specify support for greater than 64KB 


No support 


FOREGRND 


n 


Set number of Foreground Partitions 





FREQ 


f 


Specify Line Frequency Clock line frequency 


60 Hz 


HALTIO 




Include Halt I/O support 


No Halt I/O support 

I 


INTERVAL 


n 


Set Precision Interval Clock resolution 


20URNAL 


n 


Set Number of Journal entries 





LOGLEN 


n 


Set Maximum length of Logical Message 


48 


LOGQUE 


n 


Set number of slots in Log Message queue 


3 


MBUS 




The console device is on a microbus 


Not on microbus 


MEMPROT 


dn 


Include Memory Protect support 


No memory protect support 


OVCMD 




Include Command Processor system overlays 


Not overlayed 



OVSE VEN 
OVSIX 
OVTW O 
PCLOCK 



dn 



Include SVC 7 system overlays 
Include SVC 6 system overlays 
Include SVC 2 system overlays 
Specify PIC device number 



Not overlayed 
Not overlayed 
Not overlayed 
No clock support 
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■ 


Stalemeiii Operandi 




Function 


Default 1 




I'K.X n 




Define I'rocessor on the system Mode. "'0.«U.8ri.7/\b w HSALU ^ Id 

8;Ki w/M/D 




ROLL 




Include Roll-out/Roll-ln 


No Roll 




ROUND 




Include Round-Robin Schedu 


ing Round-Robin Scheduling not included 




SAFE 




Include safety checks 


No safety checks 


1 


ST 




Specify development system 


Not development system 




TASK tn,TASKlD,XFER,ip,mp, ' 


g}[,opt [.opt] ,.; 






Define a 


task to be built In 


with the OS at SYSGEN 


All tasks loaded at run-time 




UNITS n 




Set number of Logical Units per task 10 1 




VOLUME voln: 




Set system default volume 


blanks 




* 




Comment 






Examples of Configuration Statements 








Giving Typical Values and 


Recommended Device Mnemonics 






♦EXAMPLES OF CUP STATEMENTS 
CLOCK 6D 








FREQ 60 
DATEO 
PCLOCK 6C 
INTERVAL 5 

* 






change /60/50/ for Europe 
change /O/l/ for Europe 




CMDLEN 6A 
LOGLEN 48 
LOGQUE 3 

* 










CSS 2 








1 


FLOAT 2 
DFLOAT 1 
ROUND 
ROLL 

* 

JOURNAL 

SAFE 

* 

FOREGRND 2 
UNITS 10 
* 

VOLUME OSMT; 

* 

PROC 2 

MEMPROT AE 

* 

OVCMD 

OVSEVEN 
OVSLX 

OVTWO 

* 

DELETE BULKSTOR 
DELETE CMPROC 






change /O/ 1/2/3/ as required 
change /0/1/2/ as required 

change /2/1/0/ according to processor 


1 


DELETE DEBUG 
DELETE CONTIG 
DELETE INDEX 








L 
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DELETE INITIAL 


DELETE LDBG 


DELETE LOAD 


DELETE OPTIONS 


DELETE PFREC 


DELblbSETLOG 


DELETE SVCFIVE 


DELETE SVCSEVEN 


DELETE SVCSIX 


DELETE SVCTWO 


* 

ST 

* 




HALTIO 

* 




ASSIGN 


0,1,DSC1:,5 


ASSIGN 


0,5,TTY:,16 


ASSIGN 


1,3,PR:,1I4 


ASSIGN 


1,5,CRT:,34 



TASK0,TSK1D0,START0,128,120,R,FL,RES 
TASK UTSKID1,START1,128,100,D 

« 

CONSOLE 16,2,CON: 
CONSOLE 8 l,2,CONR; 

* 
MBUS 



assign 40MB disc to LU 1, task 
assign teletype to LU 5, task 
assign printer to LU 3, task I 
assign CRT to LU 5, task 1 

Define tasks in partitions and 1 
Cliange or append: /ET/FL/DFL/RES/ 

/R/D/ 
Teletype console (K/B, Printer) 
Teletype console (Reader) 

For similar devices, change /16/17/18/20/21/22/ 
Console device on microbus 

For CRT on PASLA change /1 6,2/34,10/ 



DEVICE 34,10,CRT: 



DEVICE 34,10,CRT; 
DEVICE 34,12,CRT2: 
DEVICE 34,14,CRT3: 



DEVICE 16,2,TTY: 

DEVICE 81,2,TTYR: 
DEVICE 80,13,PTRP: 

DEVICE 96,4,CR: 
DEVICE 112,62,PR: 



DEVICE 112,62,PR: 
DEVICE 112,63,PR2: 
DEVICE 112,64,PR3: 



Local CRT on PASLA 

For similar devices, change /34/36/37/38/ 

For more than one CRT: 
1st CRT 
2nd CRT 
3rd CRT 

Do not duplicate a CONSOLE specification 

Teletype on Teletype interface 

For similar devices, change /16/I7/18/20/21/22/ 

Teletype reader/punch 

Paper Tape Reader/Punch 

May change /1 3/03/ 

Card Reader 

Printer 

For similar devices, change /1 12/1 14/ 

For more than one printer: 
1st printer 
2nd printer 
3rd printer 
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DEVICE 149,10,CAR:,16 



DEVICE 149,10,CAR:,16 
DEVICE 149,12,CAR2:,16 
DEVICE I49,14,CAR3:,16 



DEVICE 64,85, MAG 1:,F0 
DEVICE 64,95, MAG2:,F0 
DEVICE 64,A5,MAG3:,F0 
DEVICE 64,B5,MAG4:,F0 



DEVICE 66,45,CAS1 
DEVICE 66,55,CAS2 
DEVICE 66,6 5,CAS3 
DEVICE 66,75,CAS4 



DEVICE 49,C6,DSC1 :,F0,B6 
DEVICE 49,D6,DSC2:, F0,B6 
DEVICE 49,E6,DSC3:,F0,B6 
DEVICE 49,F6,DSC4:,F0,B6 



DEVICE 
DEVICE 
DEVICE 
DEVICE 
DEVICE 
DEVICE 
DEVICE 
DEVICE 



51,C6,DSC1 
50,C7,DSC2 
51,D6,DSC3 
50,D7,DSC4 
51,E6,DSC5; 
50,E7,DSC6: 
51,F6,DSC7: 
50,F7,DSC8: 



F0,B6 
F0,B6 
:,F0,B6 
,F0,B6 
,F0,B6 
,F0,B6 
,F0,B6 
,F0,B6 



DEVICE 51,C6,DSC1:,F0,B6 
DEVICE 50,C7,DSC2:,F0,B6 
DEVICE 49,C8,DSC3:,F0,B8 
DEVICE 49,D8,DSC4:,F0,B8 
DEVICE 49,E8,DSC5:,F0,B8 
DEVICE 49,F8,DSC6:,F0,B8 



DEVICE 52,FC,DSC1:,F0,FB 
DEVICE 52,FD,DSC2:,F0,FB 
DEVICE 52,FE,DSC3:,FO,FB 
DEVICE 52,FF,DSC4:,F0,FB 



Remote CRT or Carousel 

For similar devices change /145/146/147/149/150/ 

For more than one: 
1st remote CRT 
2nd remote CRT 
3rd remote CRT 

May change clock selection /O/ 16/3 2/48/ 

1st magnetic tape (800 BPI) 
2nd magnetic tape 
3rd magnetic tape 
4th magnetic tape 

For 1 600 BPI, change 

/64/65/ 
/85/C5/ 
/95/D5/ 
/A5/E5/ 
/B5/F5/ 

May change selch /F0/F1/F2/F3/ 

For 7-track magnetic tape change /64/67/ 

1st Cassette 
2nd Cassette 
3rd Cassette 
4th Cassette 

1st 2.5MB 
2nd 2.5MB 
3rd 2.5MB 
4th 2.5MB 

May change selch /F0/F1/F2/F3/ 

Disc: only 10MB: 
1st removable 
1st fixed 
2nd removable 
2nd fixed 
3rd removable 
3rd fixed 
4th removable 
4th fixed 

May change selch /F0/F1/F2/F3/ 

Discs: Both 2.5 and 10 

Removable 10MB 

Fixed 10MB 

1st 2.5MB 

2nd 2.5 MB 

3rd 2.5MB 

4th 2.5MB 

Mag change selch /F0/F1/F2/F3/ 

Disc: 40MB 
1st 40MB 
2nd 40MB 
3rd 40MB 
4th 40MB 

May change selch /FO/Fl /F2/F3/ 
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DEVICE 53,FC,DSC1:,F0,FB 
DEVICE 53,FD,DSC2:,F0,FB 
DEVICE 53,FE,DSC3 :,FO,FB 
DEVICE 53,FF,DSC4:,F0,FB 



DEVICE 54,FC,DSC1 :,FO,FB 
DEVICE 54,FD,DSC2:,F0,FB 
DEVICE 54,FE,DSC3:,F0,FB 
DEVICE 54,FF,DSC4:,F0,FB 



Disc; 67MB 
1st 67MB 
2nd 67MB 
3rd 67MB 
4th 67MB 

May change selch /F0/F1/F2/F3/ 

Disc: 256MB 
1st 256MB 
2nd 256MB 
3rd 256MB 
4th 256MB 

May change selch /F0/F1/F2/F3/ 



DEVICE 55,C1,FLP1:,0 
DEVICE 55,C1,FLP2:, I 
DEVICE 55,C1,FLP3:,2 
DEVICE 55,CI,FLP4:,3 



Disc: Floppy 
1st Floppy 
2nd Floppy 
3rd Floppy 
4th Floppy 



DEVICE 
DEVICE 
DEVICE 
DEVICE 
DEVICE 
DEVICE 
DEVICE 
DEVICE 



128,20,LN0 
128,21,LN1 
128,22,LN2 
128,23,LN3 
128,24,LN4 
128,25,LN5 
128,26,LN6 
128,27,LN7 



8-line interrupt module 

1 St line 

2nd line 

3rd line 

4th line 

5th line 

6th line 

7th line 

8th line 



END 



Do not duplicate device mnemonics 
Terminate CUP/ 16 
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APPENDIX 5 
LIST OF CUP/ 16 ERROR MESSAGES 



Message 

CMND-ERR 

CODE-ERR 

COMA-ERR 

DELE-ERR 

DEVN-ERR 

DMNE-ERR 

MULT-ERR 

OFLO-ERR 

OPND-ERR 

OPTN-ERR 

PRIO-ERR 

TERM-ERR 



Meaning 

Invalid SYSGEN Command 

Invalid device code 

Missing or misplaced comma 

Invalid DELETE option 

Invalid operand 

Invalid device mnemonic syntax 

Duplicate device mnemonic 

Too many devices specified 

Invalid operand 

Invalid option mnemonic 

Invalid priority for task 

Statement does not terminate with blank or CR 
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APPENDIX 6 
SYSTEM GENERATION SAMPLE 



* Example of aOS/16 MT2 System Generation Using OS/ 16 STARTER 2 



LDBG PTRP: 

ALLOC CUPOUT,I,80 

AS 1,CR: 

AS 2,CUPOUT 

AS3,PR: 

START 

CUP/16XX-YY 

*START OF SYSGEN STATEMENTS 

UNIT 10 

VOLUME SYS: 

JOURNAL 20 

CSS 5 

CMDLEN 80 

LOGLEN 80 

CONSOLE 16,2,TTY: 

CONSOLE 8 1,2,TTYR: 

DEVICE 80, 13, PTRP: 

DEVICE n4,62,PR: 

DEVICE 96,4,CR: 

DEVICE 64,85,MAG1:,F0 

DEVICE 64,95,MAG2:,F0 

DEVICE 51,C6,DSC1:,F0,B6 

DEVICE 50,C7,DSC1 :,F0,B6 

DATEO 

FLOAT 2 

PROCO 

FOREGRND 2 

MEMPROT AE 

LOGQUE 10 

OVCMD 

OVSEVEN 

OVSIX 

OVTWO 

ROLL 

CLOCK 6D 

PCLOCK 6C 

INTERVAL 5 

SAFE 

DELETE SVCFIVE 

END 

END OF TASK 

LDBG PTRP:' 

CLALL 

AS1,CR: 

ALLOC CALOUT,I 

AS 2,CALOUT 

AS3,PR: 

ALLOC SCRAT,I,86 

AS 4,SCRAT 

AS 7,CUPOUT 

START,SCRAT 

CAL/16XX-YY 

END OF TASK 



LOAD CUP/16 FROM PAPER TAPE 

ALLOCATE A FILE FOR CUP OUTPUT 

ASSIGN INPUT FROM CARD READER 

ASSIGN CUP OUTPUT 

ASSIGN LIST OUTPUT TO THE LINE PRINTER 

START CUP 

CUP MESSAGE 

10 LOGICAL UNITS PER TASK 

SYS IS SYSTEM DEFAULT VOLUME 

20 JOURNAL ENTRIES 

5 CSS LEVELS 

80 BYTE COMMAND INPUT BUFFER 

80 BYTE LOG MESSAGE MAXIMUM 

CONSOLE TTY 

CONSOLE TTY READER 

PAPER TAPE READER PUNCH 

LINE PRINTER 

CARD READER 

MAG TAPE 

MAG TAPE 

DISC, 10MB REMOVABLE 

DISCIOMB FIXED 

US DATE 

INCLUDE FLOATING POINT 

MODEL 70, 80, 85 or 7/16 w/HSALU 

2 FOREGROUND PARTITIONS 

INCLUDE MEMORY PROTECT SUPPORT 

10 LOG MESSAGE QUEUE SLOTS 

INCLUDE COMMAND PROCESSOR OVERLAYS 

INCLUDE SVC 7 OVERLAYS 

INCLUDE SVC 6 OVERLAYS 

INCLUDE SVC 2 OVERLAYS 

INCLUDE ROLL-OUT/ROLL-IN SUPPORT 

LINE FREQUENCY CLOCK 

PRECISION INTERVAL CLOCK 

SET 5 MS CLOCK INTERVAL 

INCLUDE SAFETY CHECKS 

DELETE SVC 5 SUPPORT 

TERMINATE CUP/16 

SYSTEM MESSAGE 

LOAD CAL/16 FROM PAPER TAPE 

CLOSE UNITS 

ASSIGN OS/ 16 MT2 MAIN PROGRAM SOURCE TO CARD READER 

ALLOCATE A FILE FOR CAL OUTPUT 

ASSIGN OUTPUT TO A DISC FILE 

ASSIGN LISTING TO THE PRINTER 

ALLOCATE A SCRATCH FILE FOR CAL 

ASSIGN A SCRATCH DISC FILE 

ASSIGN SYSGEN FILE 

START CAL/16 TO ASSEMBLE EXECUTIVE 
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START.SCRAT 



RESTART TO ASSEMBLER OS/16 MT2 FILE MANAGER 



CAL/16 XX-YY 

END OF TASK 
START, SCR AT 

CAL/16 XX-YY 

END OF TASK 
LDBG PTRP: 
CLALL 

ALLOC SCRAT2,I 
AS 4,SCRAT2 
AS 5, CON: 
AS 7,C0N: 
START 

TET/16 Rxx-yy 
ESTA OS 

INCLUDE CAL0UT,EXEC16 
EDIT PTRP: 

INCLUDE CALOUT,FMGR16 
INCLUDE CAL0UT,CMDP16 
BUILD OS,OS16MT2.000 
MAP PR: 
END 

END OF TASK 



RESTART TO ASSEMBLE OS/ 16 MT2 COMMAND PROCESSOR 



LOAD TET FROM PAPER TAPE 

CLOSE UNITS 

ALLOCATE A TET SCRATCH FILE 

ASSIGN A SCRATCH FILE 

ASSIGN COMMAND INPUT TO THE CONSOLE 

ASSIGN ERROR UNIT TO CONSOLE 

START TET 

TET MESSAGE 

ESTABLISH OS 

INCLUDE THE EXEC FIRST 

EDIT THE DRIVER LIBRARY FROM PAPER TAPE 

INCLUDE THE FILE MANAGER 

INCLUDE THE COMMAND PROCESSOR LAST 

BUILD OS ON FILE OS16MT2.000 

OUTPUT A MAP ON THE LINE PRINTER 

TERMINATE TET/16 

SYSTEM MESSAGE 



A6-2 



29-431 ROl 6/76 



APPENDIX 7 
OPERATING SYSTEM ENTRY SYMBOLS 



FOR SYSTEMS WITH NO COMMAND PROCESSOR: 



ACTTCB 


DIOTRM 


LISTRE 


PLIN12 


ADD.BC 


DISARM 


LISTIN 


PLINK 


ADTSKQ 


DMT 


LOCT 


PTEDVR 


AICDVR 


DMT005 


LOCT04 


PTETRM 


AICTRM 


DMTS04 


LPS 


RDBLK 


AOCDVR 


DMTS07 


LPRDVR 


RESBIT 


AOCTRM 


DMXDVR 


LPRTRM 


SCHDP 


ASLDVR 


DMXTRM 


LPT 


SECP12 


ASLTRM 


DRET 


MDPSW 


SECPM 


ATL 


DSCDVR 


MDPSW2 


SEEKQ 


BGTCB 


DSCFEP 


MDRET 


STPD05 


BITSUB 


DSCTRM 


MHDFCB 


STPDIO 


BLOK 


DTRAPS 


MT7DVR 


SUPACT 


BUSY 


FBOT 


MT7TRM 


SVC7 


BUSY7 


FBOT02 


MTOP 


SVC7RN 


CALD12 


FBOT05 


MTPDVR 


SVCLSV 


CALDAT 


FLOAT 


MTPTRM 


SYSB02 


CBUF 


FLPSW 


MULDIV 


SYSBOT 


CBUF12 


FLPSWl 


NAEOOO 


SYSTOP 


CIORQ 


FLPSW2 


NAEOOl 


SYSVOL 


CLOCKD 


FRET 


NAE004 


TCBSAV 


CLOCKE 


III 


NAE006 


TCBT05 


CMTCOl 


IIIPSW 


NAMOOO 


TCBTAB 


CMTC06 


INCRCN 


NAMOOl 


TRAPRE 


CMTC07 


INIT 


NAM004 


TRAPS 


CMTCB 


INMARK 


NAM006 


riYDVR 


CR2DVR 


INMDVR 


NAMCHK 


TTYTRM 


CR2TRM 


INMTRM 


OSDB06 


UBOT 


CRASHX 


INTDVR 


OSDB07 


UBOT03 


CRDDVR 


INITRM 


OSFOOl 


UBOT04 


CRDTRM 


lODONE 


OSF006 


UBOT05 


CRSHSV 


lOEXIT 


OSFD06 


UBOT07 


CUDL 


lOLIST 


OSFD07 


VMT 


DBDSCl 


lOPTST 


OSFD08 


VOLCOO 


DBNUOl 


lORSAV 


OSOVDB 


VOLCOl 


DBNU03 


lOTERM 


OSOVFD 


VOLC02 


DBNU04 


lOTWAT 


OSOVST 


VOLC04 


DBNU05 


JOURNL 


OSSTOl 


VOLC06 


DBNULL 


LIOT05 


OVIO 


VOLCHK 


DBPTRP 


LIOTRM 


OVLU 


ZERO 


DIODVR 


LIST2 


PFFLAG 


.74TSV 
.SYS 



FOR ABOVE SYSTEMS WITH ITAM SUPPORT, INCLUDE: 



BISCLO 
BISP07 



BS2DVR 
BS2TRM 



BS3DVR 
BS3TRM 



BSPDVR 
BSPTRM 
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APPENDIX 8 
SYSTEM DATA 



This Appendix contains miscellaneous data on the size and timings of various system modules and information on overall 
system performance. 

Approximate OS/16 MT2 system sizes: 



System 


Small 


Large 


Non-disc system 


16KB 


26KB 


Non-overlayed disc system 


32KB 


42KB 


Overlayed disc system 


14KB 


28KB 


Executive-only system 


4KB 


7 KB 


Executive and File Manager only system 


8KB 


12KB 



Approximate Minimum Memory Requirements for the OS/16 MT2 system and standard utility programs. 



Program 


Small Non-Disc System 


Full Disc System 


CAL 


40KB 


40KB 


CAL/16 


32KB 


32KB 


OS EDIT 


24KB 


32KB 


FORTRAN V 


40KB 


48KB 


FORTRAN IV 


32KB 


32KB 


BASIC 


24KB 


32KB 


OS AIDS 


24KB 


32KB 


LIBRARY LOADER 


24KB 


24KB 


OS COPY 


16KB 


24KB 


CUP/ 16 


24KB 


24KB 


TET/16 


24KB 


32KB 


DISC INTEGRITY CHECK 


24KB 


24KB 


DISC COMPRESS UTILITY 


24KB 


24KB 


SOURCE UPDATER 


24KB 


24KB 
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Approximate 6/16 Timings for Instructions Using Software Traps in Microseconds 



Multiply by .75 for 8/16 times 
Multiply by 1.2 for 5/16 times 
Multiply by 1 .3 for 7/16 times 



INSTRUCTION 


TIME 


ATL 


160 


ABL 


150 


RTL 


150 


RBL 


160 


MH 


500 


MHR 


490 


DH 


450 


DHR 


440 


MHU 


490 


MHUR 


480 


LER 


220 


CER 


220 


AER 


300 


SER 


300 


MER 


330(2100forPROC2&3) 


DER 


690 


STE 


190 


LE 


230 


CE 


230 


AE 


310 


SE 


310 


ME 


390(2100forPROC2&3) 


DE 


700 


LME 


410 


STME 


400 


FLR 


400 


FXR 


410 


LDR 


320 


CDR 


320 


ADR 


420 


SDR 


420 


MDR 


580 (7000 for PROC 2 & 3) 


DDR 


1650 


SFD 


290 


LD 


330 


CD 


330 


AD 


430 


SD 


430 


MD 


590 (7000 for PROC 2 & 3) 


DD 


1660 


LMD 


710 


STMD 


700 


FLDR 


700 


FXDR 


620 
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Approximate OS/ 16 MT2 Module Sizes 



FUNCTION DELETED 


NO. BYTES (DECIMAL) 


COMMAND SUBSTITUTION SYSTEM ICSS) 


2000 


CLOCK SUPPORT; SET TIME, DISP TIME 
COMMANDS; SVC, 2 CODES 8, 9, AND 23 


200 


JOURNAL SUPPORT 


100 


SAFETY CHECKS 


100 


ROLL IN/OUT SUPPORT 


300 


FOREGROUND SUPPORT; TASK 
COMMAND 


1000 


INDEXED FILE SUPPORT 


1000 


ALL SVC 6, IMAGE LOADER, OVER- 
LAY LOADER 


1500 


SVC 6 IMAGE LOADER 


850 


SVC 5 (OVERLAY LOADER) 


100 


DISC SUPPORT; ALLOC.DELETE; 
FILES, INITIALIZE, SAVE, CLEAR, AND 
VOLUME COMMANDS; SVC 7 FILE MAN- 
AGEMENT SUPPORT 


4000 


BULK STORE COMMANDS (RW, FF, FR, 
BF, BR) 


100 


SYSTEM INITIALIZATION CODE AFTER 
SYSTEM IS INITIALIZED 


500 


OPTIONS COMMAND 


100 


EXAMINE, MODIFY AND BIAS 


200 


DISPLAY COMMANDS 


1200 


SET LOG COMMAND 


200 


RESIDENT OBJECT CODE LOADERS 


750 


SET PARTITION COMMAND 


100 


HALT I/O SUPPORT 


250 


GENERAL SUPERVISOR SERVICES 
(SVC 2) 


1280 


SOFTWARE EMULATION OF M/D 
INSTRUCTIONS 


340 


POWER FAIL RECOVERY 


250 
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Driver Library Routines 


Number of Bytes 




(Decimal) 


ASYNC CRT Driver 


1490 


7-Traeli Mag Tape Driver 


1080 


Teletype Driver 


1010 


Card Reader Driver 


390 


Converting Card Reader Driver 


250 


Line Printer Driver 


230 


HSPTR/P Driver 


610 


9-Traclc Mag Tape Driver 


530 


Cassette Driver 


810 


Digital Mux Driver 


100 


8-Line Interrupt Module Driver 


180 


Disc Driver 


1050 


Analog Input Driver 


210 


Analog Output Driver 


80 


Digital I/O Driver 


490 


Floppy Disc Driver 


1000 



Software Traps 


Number of Bytes 
(Decimal) 


Fixed Pt. Mult/Divide Instructions 

List Instructions 

Single Precision Floating Point Instructions 

Double Precision Floating Point Instructions 


340 

320 

680 

1200 



Miscellaneous 


Number of Bytes 


Non-Disc Device Control Block 


78 


(1 per device) 




Disc Device Control Block 


422 


(1 per Disc) 




Task Control Block (1 per 


88+3* UNITS 


partition) 






44 


Contiguous File Control Block 




(1 per assigned Contiguous File) 


104 + index block size 


Index File Control Block (1 per 


+ data block size 


assigned Index File) 






36 (68 with SPFP 


User Dedicated Locations (UDL) 


132 with DPFP) 


(1 per Partition) 




Log Message Queue 


LOGQUE*(LOGLHN+12) 


Command Processor Buffers 

, 1 


(CMDLEN+2) * (CSS+2) 
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APPENDIX 9 
GLOSSARY OF TERMS 



Certain terms, which are used often in OS/16 MT2 documentation and which must be understood by the reader in order to 
gain a good understanding of the concepts, are defined as follows: 



ABSOLUTE 
ACCESS METHOD 
ACCESS PRIVILEGE 

ALLOCATION 

ASCII (American Standard Code for 
Information Interchange) 

ASSEMBLER 

ASSIGNMENT 

ATTRIBUTES 

BLOCK (OR PHYSICAL BLOCK) 

BUFFER 

BULK STORAGE 



COMPILER 



A term applied to a load module meaning that it must be loaded into memory at a 
specific location which cannot be altered at load time. 

A well-defined technique for identifying, retrieving, and storing specific records in 
a file. The access method is chosen at the time of a read or write call on the file. 

An attribute of a system resource which defines a level of protection on that 
resource. Resources may be requested by a user for shared or exclusive access and 
specific I/O capabilities within that access. Examples of access privileges are; 
Shared Read Only (SRO), Exclusive Read, Sharable Write (ERSW). 

The process of creating a file on a direct access volume. 

The standard code used for information interchange among data processing com- 
munications systems. ASCII is a 7-Bit code plus 1 Bit which may be used for 
parity check. INTERDATA software uses ASCII internally (7-Bit ASCII with the 
parity Bit always set to zero). Synonyms; USASCII,ANSCI1. 

An Assembler translates programs written in a symbolic machine language into a 
form which can be conveniently loaded into the system by a loader program. 
INTERDATA provides Assembler programs which convert Assembly Language 
Programs into binary object format. 

The process of binding a specific physical device or direct access file to a Logical 
Unit. 

The possible physical/logical functions and characterisfics of any given device or 
direct access file. 

A physical unit of data accessed by a single Input/Output operation by the 
system. 

An area of main memory used for the transfer of blocks to and from external 
storage. A buffer may be internal to the user program, or external to it, depending 
on the buffer management method. 

Storage of large-volume capacity used to supplement the Processor's internal 
memory. Discs (direct access devices) and Magnetic Tapes are used for bulk 
storage. 

A Compiler accepts programs expressed in a given language; i.e., the argument 
language, and produces corresponding programs expressed in a second language; 
i.e., the funcfion language. For example, FORTRAN V Level 1 produces as its 
function language the INTERDATA CAL assembly language. 
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DEVICE CODE 

DEVICE NUMBER 

DIRECT ACCESS DEVICE 

FILE 

FILE CONTROL BLOCK (FCB) 

FILE DESCRIPTOR 
FILE STRUCTURE 

FULLWORD 
HALFWORD 
LOAD MODULE 
LOGICAL UNIT 
MULTISWITCH 

OBJECT MODULE 

PARTITION 

PRIVILEGED INSTRUCTIONS 

PROGRAM STATUS WORD (PSW) 

PROGRAM 

PROTECTION KEYS 

REAL-TIME 



A decimal number from 0-255 which identifies the class of device to the operating 
system. Device codes 0-15 identify direct access file types. 

A two digit hexadecimal number which is the physical address of a device as 
configured in the hardware system. 

Any bulk storage medium that can be accessed in a random manner. Under OS/32 
or OS/16 the smallest addressable unit is a sector. 

A collection of related records, treated as a unit and organized for reference in a 
well-defined manner. 

A Control Block dynamically allocated as required whenever a direct-access file is 
assigned. FCB's contain information required for the processing of a file. 

An ASCII string of characters following certain syntactical rules which show the 
location of direct-access files or non-direct access devices. 

The physical means whereby a file is organized on a volume for reference by a 
bufl^r management method and access method. The file structure of any given 
file is fixed at the time the file is initially allocated. 

A collection of data, 32 Bits (four Bytes) in length, processed as a unit, whose 
address is a multiple of 4. 

A collection of data, 16 Bits (two Bytes) in length, processed as a unit, whose 
address is a multiple of 2. 

A module capable of being loaded into an operating system environment, and 
executed as a task. 

All task I/O requests are directed to Logical Units, which are pseudo devices 
associated with the task. 

Vector of branches entered by an indexed branch, analogous to the FORTRAN 
computed GOTO facility. 

The output of a language Processor. 

Contiguous Area of Memory reserved for task, resident library or task common. 

Instructions that relate to I/O or change the state of the Processor. 

The PSW defines the state of the Processor at any given time. 

A sequence of statements possessing some implicit or explicit order of execution, 
and specifying a computer-oriented representation of a process. 

A set of values associated with a device or file which must be supplied by users in 
order to obtain access to that device or file. 

Capability of performing computations related to a physical process during the 
actual time that the process transpires. This is generally required where the results 
of the computation arc to be used in guiding the physical process. 



RECORD (OR LOGICAL RECORD) 



RELOCATABLE 



ROLL 



A collection of data items treated logically as a unit, accessed by a single 
input/output operation by a user task. 

Term applied to a load module meaning that it may be loaded into memory at 
any location. 

A technique of saving the necessary control informafion, code and data of a low 
priority task on external storage (Roll Out) so a higher priority task can use the 
memory; on completion of the higher priority task the rolled out task resumes 
execution from the point of interruption (Roll In). 
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SECTOR 

SOURCE MODULE 

SUPERVISOR CALL (SVC) 

SYSGEN (System Generation) 

SYSTEM QUEUE 

TASK 

TASK CONTROL BLOCK (TCB) 

TASK OPTIONS 

TASK STATUS 

TASK STATUS WORD (TSW) 
VOLUME 



In general, the smallest segment of a direct access device which may be randomly 
addressed; specifically in OS/32 or OS/16, a 256-Byte unit of storage. 

A mnemonic or easy to read representation of a program to be input to a language 
Processor. 

The SVC Instruction provides the user program with the capability of requesting 
Operating System Services. 

The building of a system from a library of source or object modules. 

A feature of the Processor used by the operating system to aid in scheduling. 

The unit of work known to the Executive portion of the Operating System. 

The interface between tasks and system routines is provided through an internal 
system table called the Task Control Block. 

These variables, which the user may select, affect the mode of operation of the 
task. 

The state of a task while it is known to the system (e.g. Dormant, I/O wait, 
Active). 

Task analog of the PSW. Defines the state of a task at any given time. 

A physical unit of external storage media, for example a Disc Cartridge or Pack. 
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INDEX 



Assemblies, the Sysgen, 4-16 
Assigning Logical Units, 4-8 

BASIC Level II, Support for, 2-10 
Buffer Length, Command, 4-14 
Buffer Length, Log Message, 4-14 
Building the System, 2-8 

Clock Support, 2-4, 4-9 

Command Buffer Length, 4-14 

Command Processor, Deleting the, 2-5 

Command Substitution System, 2-4, 4-14 

Compatibility, Driver, 5-8 

Compatibility, File, 5-6 

Compatibility, Memory Management, 5-8 

Compatibility, Operator Command, 5-6 

Compatibility, SVC, 5-1 

Configuration Statement Description, 4-2 

Configuration Statements, Hardware Related, 4-4 

Configuration Statements, Operator Related, 4-14 

Configuration Statements, Task Related, 4-9 

Configuration Utility Program, 4-1 

Console Description, Device and, 4-6 

Default Volume, 4-8 

Deleting the Command Processor, 2-5 

Deleting the File Manager, 2-6 

Deleting Multiply/Divide Software Support, 2-6 

Deletion, Module, 4-12 

Deletion, System Module, 2-5 

Description, Device and Console, 4-6 

Description, System, 1-1 

Device and Console Description, 4-6 

Device Configurations, Example of, 4-6 

Disc Support, Features Requiring, 4-12 

DiscSystem, 4-18, 4-20 

Documentation Overview, 1-1 

Documentation Package, 3-1 

Double Precision Floating Point, 4-4 

Driver Compatibility, 5-8 

Error Recovery, 2-9 

Example of Device Configurations, 4-6 

Example of Program Development System, 4-20 

Extended Memory, 4-9 

Extended Memory, Referencing, 7-1 

Extended Single Precision Instructions, 4-4 

Features Requiring Disc Support, 4-12 
File Compatibility, 5-6 
File Manager, Deleting the, 2-6 
Floating Point, Double Precision, 4-4 
Floating Point, Single Precision, 4-4 
FORTRAN Programs, Support for, 2-13 
Function Deletion and System Overlays, 2-2 
Functional Program Package, 3-2 

Halt I/O Support, 4-8 

Handling, Trap, 2-9 

Hardware Related Configuration Statements, 4-4 

Hardware Related Planning, 2-4 

Instructions, Operating, 4-15 
1/0 Support, Halt, 4-8 



Logical Units, Assigning, 4-8 
Log Message Buffer Length, 4- 
Logging, Message, 4-15 



14 



Media, 3-3/3-4 

Memory Extended, 4-9 

Memory Management CompatibiUty, 5-8 

Memory Protect, 4-9 

Message Logging, 4-15 

Module Deletion, 4-1 2 

No Command Processor, Systems with, 4-19 
Non-Disc Systems, 4-17, 4-19 

Operator Command Compatibility, 5-6 

Operating Instructions, 4-15 

Operator Related Configuration Statements, 4-14 

Organization Manual, 1-2 

Overview, Documentation, 1-1 

Packaging Contents, 3-1 

Package, Documentation, 3-1 

Package, Functional Program, 3-2 

Package, Source Program, 3-1 

Partitions, Tasks and LU Assignments, Setting of, 2-6 

Planning, Hardware Related, 2-4 

Planning, System, 2-1 

Power Fail, Recovery, 2-9 

Program Development System, Example of, 4-20 

Program Package, Functional, 3-2 

Program Package, Source, 3-1 

Protect, Memory, 4-9 

Recovery, Error, 2-9 
Recovery, Power Fail, 2-9 
Referencing Extended Memory, 7-1 

Scheduling, 2-4 

Setting of Partitions, Tasks and LU Assignments, 2-6 

Single Precision Floating Point, 4-4 

Single Precision Instructions, Extended, 4-4 

Software Support, Deleting Multiply/Divide, 2-6 

Source Program Package, 3-1 

Statement Description, Configuration, 4-2 

Substitution System, Command, 2-4, 4-14 

Support, Clock, 2-4, 4-9 

Support for BASIC Level IL 2-10 

Support for FORTRAN Programs, 2-13 

SVC Compatibility, 5-1 

Sysgen Assemblies, the, 4-16 

System Building the, 2-8 

System Description, 1-1 

System, Disc, 4-18, 4-20 

Systems, Linking the, 4-17 

System Module Deletion, 2-5 

Systems, Non-Disc, 4-17, 4-19 

System Overlays and Function Deletion, 2-2 

System Planning, 2-1 

Systems with No Command Processor, 4-19 

Task Related Configuration Statements, 4-9 
Trap Handling, 2-9 

Utility Program, Configuration, 4-1 
Units, Logical, 4-7 

Volume, Default, 4-8 



Linking the Systems, 4-17 
Logical Units, 4-7 
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